Ambassador

The Ambassador Developer Hub

Welcome to the Ambassador developer hub. You'll find comprehensive guides and documentation to help you start working with Ambassador as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Authentication

You can authenticate with the Ambassador API using your username and API key. You can find this information on your account settings page. Your API key should never be shared or exposed. We provide an embeddable JavaScript snippet and SDKs for client-side integrations.

Credentials:

  • [[app:username]]
  • [[app:key]]

URL Structure for an API Call:
https://getambassador.com/api/v2/[[app:username]]/[[app:key]]/json/event/record

Passing your API token in the request header

Alternatively, you can add your API key in the request header. The requires a change to the URL structure. For example:

This call:

https://getambassador.com/api/v2/[[app:username]]/[[app:key]]/json/event/record

changes to:

https://getambassador.com/api/v2/[[app:username]]/token/json/event/record

After changing the URL structure, you will need to pass your token in the header. Here's an example:

Authorization: Token [[app:key]]