The Trade Desk API - Troubleshooting

While configuring your The Trade Desk API connection, you may encounter several issues. Understanding these common errors can help streamline the setup process and facilitate quick resolutions.

Authorization issues

Error message:

This error occurs when the authenticated user does not have Public API access enabled in The Trade Desk Partner Portal. Even if your login and password are correct, the API token will not have the necessary permissions without this enablement. or when the API access token has expired. Since TTD uses a login/password authentication flow that issues a short-lived token (valid for 24 hours),

Solution:

• Ensure you’re using the refreshed token in your API calls (tokens expire every 24 hours).‍
• ‍Ask your Trade Desk representative or account manager to enable Public API access for the user you authenticate with — at minimum the PublicAPI_General_View scope, plus any additional scopes your integration requires. This is an account-side setting and one of the most common blockers when connecting to the TTD API.

Wrong permissions

Error message:

‍‍This error occurs when the user can view reports but does not have permission to create or schedule them.

Solution:

• Ask your Account Manager to grant Scheduling API access and report creation permissions.
• In User Management Platform (UMP), ensure the API user:
  • Has access to the required advertisers
  • Has permissions to create and schedule reports (not view-only)

An admin can review and update these settings in UMP.