API endpoints

Understand how to access our regional API endpoints.

🚧

Secure access

For security reasons all your API requests must be made via HTTPS. Our servers use SHA-256 certificates and support TLS v1.2 and 1.3.

Region specific endpoints

Dotdigital accounts belong to different regions, depending upon where they are based in the world. Our APIs require you to use the correct API endpoint for your region. This is important as you cannot use an API endpoint belonging to a different region.

If you don't know your account's correct API endpoint, then you can find this out in a couple of ways:

  • In Dotdigital Marketing: Expand the User menu in the bottom left and go to Settings > Access > API users.

    Your API endpoint is displayed at the top of the page. Only account owners or users with the Can manage account permission enabled can view the Access area.

Region info example
  • Via API: Call Get Account Information using r1-api.dotdigital.com as the regional endpoint (regardless of what region you're in), and this returns your account's correct endpoint.

The regions are:

RegionRegion idAPI Domain
Europer1r1-api.dotdigital.com
North Americar2r2-api.dotdigital.com
Asia Pacificr3r3-api.dotdigital.com
🚧

Maximum call times

Ensure that, when calling the APIs, your client permits 121 seconds call duration before considering the call timed out.



What’s Next