Skip to contentSkip to navigation

List Account Campaigns Beta

The campaigns one email account is assigned to.

GET /api/v1/email-accounts/{account_id}/campaigns

Requires an API key with the read scope. Returns up to 100 campaigns, newest first.

Path Parameters

account_id string path required

The unique identifier of the email account.

Response

data array
data
id string
Campaign identifier.
name string
Campaign name.
status string
draft, active, paused or completed.

Errors

StatusDescription
401Missing, invalid, revoked or expired API key
403API key does not have the required scope: read
404Email account not found, or it belongs to another workspace

Rate Limit

  • 600 requests per minute, shared by every poll call in your workspace. Fixed 60-second window.
  • Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (unix epoch seconds) and X-RateLimit-Bucket (poll).
  • A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns (Retry-After, exponential backoff, monitoring X-RateLimit-Remaining), see Rate Limiting.

Was this page helpful?