Creating the POST callback endpoint

1. Expose a POST endpoint in your backend

Expose a POST endpoint (preferable ending with /telematica-callback) in your backend, which will receive callbacks. It is advised to add a bearer token as security for this endpoint.

2. Configure your backend

Configure your backend to save user-to-device mapping in your database and other webhook events when a POST call comes in from Telematica on the above endpoint.

You can expect the POST request body to follow the schema mentioned here.

3. Share the endpoint with Telematica

Share the endpoints you've created with us or configure them in your Webhook Dashboard.


Why is there a callback endpoint?

Once the end user logs in with their OEM credentials, we make a callback to your backend to pass on the information to your backend. This endpoint is also used to send other Webhook events to your backend.

Can I add an authentication token to the POST endpoint?

Sure. Please make sure your backend accepts the token in following header format:

--header 'Authorization: Bearer QOkDgC532UGa9pK3L0a'

Can I make different endpoints for different environments (dev, stage, prod) ?

Yes. Telematica will hit the prod endpoint by default if no special query parameter is present.

To indicate Telematica to make callback on any other endpoint, please add a callbackEnv parameter in the consent UI