Get API keys Not authorizedAdd an API key and secret to send requests from this page.

Integrate API

Build secure server-to-server integrations with Integrate to manage leads, lists, and reports.

Base URL
Environment
AuthenticationTwo headers on every request: X-API-Key and X-API-Key-Secret
API keysAccount admins create a key and secret in Admin center, under Keys & credentials. Use Get API keys at the top of any page. The secret is shown once, so store it straight away.
FormatRequests and responses are JSON.

Quickstart

Keep your key and secret on your server. Every example on this site reads them from environment variables. Set those once, replace any ID placeholders at the top of an example, and it runs as written.

  1. Store your key as environment variables

    The examples read these three names. Your organization ID is your account ID, shown as ID on the Account admin > Overview page.

    Shell
  2. Make your first call

    List the lists in your organization. A 200 response with a result array means your key works.

    cURL
  3. Or try it here

    Choose Authorize at the top of the page and enter your key, secret and organization ID once; every endpoint's Try it then uses them. They are held only in this tab and never appear in the examples.

Errors

Most failures return JSON with an errors list of readable messages. Each endpoint page shows its exact error bodies. 401, and 403 for a role problem, come back with an empty body.

StatusMeaningWhat to check
400The request is invalid.The errors message names the field or rule.
401The key and secret were not accepted. Empty body.Send both headers, with a key from this site's environment that hasn't expired. A path or method that doesn't exist, or an ID in the path that isn't a GUID, also returns 401.
403The key can't do this.With an empty body: the key's role, or a feature that needs a paid license. With a detail message, or on Get organization an error object with code ERR8002: organizationId in the path isn't your key's account.
404Nothing exists at this ID.The ID, and that it belongs to your organization.
415Wrong Content-Type.Use the content type shown on the endpoint's page.
422Submit lead only: the lead can't be processed.The source ID, and that every required field of the source is present.
5xxSomething failed on our side, or a service didn't answer (502, 503, 504).Retry after a short wait. If it keeps failing, contact support@integrate.com with the time, the endpoint and the response.
Error response

Authorize this tab

Enter your API key, its secret and your organization ID to send requests from this site. They are held only in this tab's memory and never saved. The secret is never shown on screen, and all three are forgotten after minutes with no activity on this page, or when you close the tab.

Your account ID, shown as ID on the Account admin > Overview page, as a UUID. It fills organizationId on every endpoint.
No key in this tab