Skip to main content

Integrating with the Plugchoice API

The short partner guide: where the docs live, how OAuth works for your customers, and how to get access.

The Plugchoice REST API lets you build your own product on top of the platform: read chargers, sessions and meter values, start and stop charging, manage cards, sites and power management, and more. This page is the short version for partners; the full technical documentation lives at developer.plugchoice.com.


Where the documentation lives


Two ways to authenticate

  • Personal access token: the quickest start. Generate one under Settings > Personal Access Tokens in the Plugchoice dashboard and you can call the API on your own account straight away. Ideal for scripts, testing and internal tooling.

  • OAuth 2.0: for products your customers use. Your application gets its own access to each customer's data, with their permission, without anyone sharing passwords or tokens.


What OAuth looks like for your customer

  1. In your app, the customer clicks something like Connect Plugchoice.

  2. They land on the familiar Plugchoice login screen and log in with their own account.

  3. Plugchoice asks them to approve the access your app requests, one click.

  4. They are sent straight back to your app, which now securely receives its own tokens for that customer.

No manual token copying, no shared passwords, and the customer can withdraw the access again at any time. This is the same flow customers already know from connecting other services.


Getting access

To enable OAuth for your application we only need one thing from you: your redirect URL (the address in your app the customer returns to after approving). Send it to us via the messenger or your partner contact, and we set up your OAuth client and send you the credentials.

Personal access tokens need no setup from us at all: create one in the dashboard and start building.


See also

Did this answer your question?