Skip to main content
All requests to the Everflow API must be made over HTTPS and authenticated using an API key.

​
Making requests

The base URL for all API requests is: 
https://api.eflow.team/v1
A small subset of Everflow accounts are hosted on EU servers only. For those accounts the base URL is https://api-eu.eflow.team/v1. If you’re unsure whether this applies to your account, check with your account manager.
Include your API key in the X-Eflow-API-Key header on every request. The Accept header is optional but can be set to application/json. When submitting data via POST, PUT, or PATCH, send the payload as JSON. 
curl -H "X-Eflow-API-Key: <your-api-key>" \
  https://api.eflow.team/v1/networks
Requests made without authentication will fail with a 401 error. Using an API key for the wrong portal (e.g. an Affiliate key to access a Network endpoint) returns a 403 Out of realm error.

​
API key types

Each Everflow portal has its own API keys. The base URL path prefix changes depending on the portal:
PortalBase pathKey created by
Network/v1/networks/...Network users, under Control Center > Security
Affiliate/v1/affiliates/...Network users, under Manage Affiliate > API tab
Advertiser/v1/advertisers/...Network users, under Manage Advertiser > API Keys tab
Marketplace/v1/partners/...Must be requested from your account manager

​
Key management

  • API keys are shown only once at creation time. Store them securely.
  • Each Network API key has its own set of permissions, independent of the user it is associated with.
  • Affiliate and advertiser users cannot create keys themselves; a network user must create and provide the key.
  • If a key is compromised, revoke it immediately in the Everflow UI.
  • For a detailed walkthrough on managing API keys and configuring security settings, see the Security Settings guide.

​
Example requests

Network API
curl -H "X-Eflow-API-Key: <your-api-key>" \
  https://api.eflow.team/v1/networks
Affiliate API
curl -H "X-Eflow-API-Key: <your-api-key>" \
  https://api.eflow.team/v1/affiliates/affiliate
Advertiser API
curl -H "X-Eflow-API-Key: <your-api-key>" \
  https://api.eflow.team/v1/advertisers/advertiser