Skip to main content
The Benchmark Email API lets you manage contacts, campaigns, reports, and domains programmatically. Use it to build custom integrations, automate workflows with tools like Zapier or n8n, or sync data between Benchmark Email and your other systems.

​
Quick Start

​
1. Create an API Key

  1. Log in to Benchmark Email as an account owner.
  2. Go to Settings > API Keys.
  3. Click Create API Key.
  4. Give it a name (e.g., “My Integration”) and select the permissions you need.
  5. Copy the key immediately — it will only be shown once.

​
2. Make Your First Request

curl -H "X-API-Key: bme_your-api-key-here" \
  https://api-us1-1.benchmarkemail.com/api/contact-structure
You should receive a JSON response with your contact structure, including your custom field definitions. If you get a 401 or 403 error, see the errors guide for troubleshooting.

​
API Reference

DocumentDescription
AuthenticationHow to authenticate requests, scopes, and account requirements
Rate LimitsHourly rate limits, monthly quotas, and response headers
ErrorsError response format, status codes, and common error scenarios
API ReferenceBrowse the full OpenAPI specification

​
Available Resources

ResourceScopesWhat You Can Do
Contactscontacts:read, contacts:writeCreate, read, update, delete contacts; manage lists; update custom fields; search and export contacts
Campaignscampaigns:read, campaigns:writeCreate, read, update, delete, and duplicate email campaigns; browse templates
Reportsreports:readView dashboard summaries and email performance reports
Domainsdomains:readView email sending domains

​
Base URL

Your API base URL is region-specific and displayed on your Settings > API Keys page. It follows this pattern: 
https://api-{region}-{cluster}.benchmarkemail.com
All API paths in this documentation are relative to your base URL. For example, the contacts endpoint is: 
{base_url}/api/contact

​
Scenario Guides

For step-by-step walkthroughs of common workflows, see the scenario guides.