Welcome to the Reply.io API guide. Let’s get you integrated smoothly!

API Endpoint

Our platform utilizes the endpoint: api.reply.io. We offer two versions of our API: V1 and V2, each with its unique functionalities. You’re free to employ both versions in tandem if desired.

Authentication

  1. Log in to your Reply account.
  2. Navigate to Settings → API Keys.
  3. Choose the appropriate key type and copy its value.

Key Types & Access Levels

Key TypeExample PrefixScopeTypical Use
Userusr_xxxA single user’s data & actionsPersonal scripts and one‑off integrations
Teamteam_xxxAll members within a single teamShared dashboards, team automations
Organizationorg_xxxEntire organization across all teamsCompany‑wide BI, system‑level integrations

Note: API rate limits are tracked per key. Separate keys help teams monitor usage independently.

Constructing API Requests

All your requests will start with either:

  • https://api.reply.io/v1/
  • https://api.reply.io/v2/

Response Codes

  • 200All good! Request was successful.
  • 201Success! A new item was created.
  • 400Uh‑oh! There’s an issue with your input parameter. Check the response for more information.
  • 401User not found. No users match the API key provided.
  • 403Access denied. The API key doesn’t have the required permissions for the resource.
  • 404Resource not found. Double‑check your URL or identifier. More details can be found in the response.
  • 500Our bad! Internal server error. We’ve been notified and will get on it ASAP.

Rate Limits

To ensure optimal performance and equitable usage for all users, the Reply API enforces:

  • Monthly API Calls: Up to 15,000 calls per key per month.
  • API Throttling: No general throttling, but certain requests may be subject to throttling. Refer to the specific request documentation for details.

Welcome to the Reply.io API guide. Let’s get you integrated smoothly!

API Endpoint

Our platform utilizes the endpoint: api.reply.io. We offer two versions of our API: V1 and V2, each with its unique functionalities. You’re free to employ both versions in tandem if desired.

Authentication

  1. Log in to your Reply account.
  2. Navigate to Settings → API Keys.
  3. Choose the appropriate key type and copy its value.

Key Types & Access Levels

Key TypeExample PrefixScopeTypical Use
Userusr_xxxA single user’s data & actionsPersonal scripts and one‑off integrations
Teamteam_xxxAll members within a single teamShared dashboards, team automations
Organizationorg_xxxEntire organization across all teamsCompany‑wide BI, system‑level integrations

Note: API rate limits are tracked per key. Separate keys help teams monitor usage independently.

Constructing API Requests

All your requests will start with either:

  • https://api.reply.io/v1/
  • https://api.reply.io/v2/

Response Codes

  • 200All good! Request was successful.
  • 201Success! A new item was created.
  • 400Uh‑oh! There’s an issue with your input parameter. Check the response for more information.
  • 401User not found. No users match the API key provided.
  • 403Access denied. The API key doesn’t have the required permissions for the resource.
  • 404Resource not found. Double‑check your URL or identifier. More details can be found in the response.
  • 500Our bad! Internal server error. We’ve been notified and will get on it ASAP.

Rate Limits

To ensure optimal performance and equitable usage for all users, the Reply API enforces:

  • Monthly API Calls: Up to 15,000 calls per key per month.
  • API Throttling: No general throttling, but certain requests may be subject to throttling. Refer to the specific request documentation for details.