Skip to main content

​
Authentication

All API requests require authentication using a Bearer token. To get your API key:
  1. Log in to your Gojiberry AI account at https://app.gojiberry.ai
  2. Navigate to Settings → API section
  3. Click “Create API Key” to generate a new token
  4. Copy the API key when it’s displayed (you won’t be able to see it again)
  5. Use the token in your requests by adding the header: Authorization: Bearer YOUR_API_KEY

​
Impersonation (organization owners)

If your API key belongs to the owner of an organization, you can perform any API call on behalf of another member of your organization by adding the x-impersonate-user-id header with the member’s user ID:
When impersonating, the request behaves exactly as if it was made by that member: you read and write their data (contacts, campaigns, lists, unibox, etc.). Rules:
  • Your API key must belong to the organization owner; other members cannot impersonate.
  • The impersonated user must belong to the same organization as the API key user.
  • Requests that don’t meet these rules are rejected with a 401 Unauthorized.
Tip: use GET /v1/organization/members to list the members of your organization and their user IDs, and GET /v1/user/me to verify which user the current request acts as.

​
Rate limits

  • 100 requests per minute per account. Short bursts above this are tolerated.
  • 100,000 requests per day per account.
  • Limits are shared by all API keys and AI app (MCP) connections of the same user, including calls made on behalf of organization members with x-impersonate-user-id.
  • Requests over a limit return 429 Too Many Requests with a Retry-After header (in seconds). Wait that long before retrying.
  • Some endpoints have their own lower limit, stated in their description.

​
Base URL

Production: https://ext.gojiberry.ai