How Do I Send Data to a Performance Data API Integration?

Last updated: November 17, 2026

Your system sends data to Ambition with a POST request to the endpoint listed on the integration's Credentials page. Each request must carry the integration's token and match the Data Format you saved.

Required permissions:

  • The Integrations: Edit permission is required to view an integration's credentials.

Find Your Credentials

  1. Go to Admin --> Data --> Integrations and open the Enabled tab.

  2. Click on the integration's name.

  3. In the side menu, click on Credentials. The Authentication Token, Route, and Endpoint fields will be listed under API Credentials.

Build the Request

  • Endpoint: Post to the URL in the Endpoint field, which looks like https://yourcompany.ambition.com/api/v3/data/your-route/. Keep the slash at the end.

  • Authorization header: Authorization: Token followed by a space and your Authentication Token.

  • Content-Type header: application/json, text/csv, application/vnd.ms-excel, or text/plain.

  • Body: The CSV or JSON data, using the field keys from your Field Mappings. Each request can be up to 15 MB.

Check the Response

  • 201: The data was accepted.

  • 400: The data was rejected. The response lists each error's message and ID.

  • 404: The route isn't active, or the integration has an open issue.

Note:

  • To try requests before writing code, click on API Sandbox on the Credentials page.


Related Articles