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 over Email.
Also share the authentication token for endpoint if you have any.

FAQs

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.

The information shared includes deviceId in our database and userId in your database to map it to.

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 callbackUrl parameter in the consent UI