Heads up: API 2.0 is on the way!
If you're looking for updated API documentation for Prospect, Validation, Design, or Google Postmaster tools, check out the 250ok API 2.0 Developer Guide. Thank you for your patience as we migrate existing products to the new APIs.
All API requests utilize REST methods resulting in JSON, XML, CSV, or Serialized output. To request new API functionality please feel free to contact us.
Every API request requires the use of the
X-API-KEY header, which is located in your account settings. For child API keys please visit the Child Accounts section of your settings.
- Package API request using the programming language of your choice
- Perform data GET/PUT/POST/DELETE requests to https://api.250ok.com/api/1.0/
- Return data in the format of your choice using the
Accounts: Added "Get GDPR Requests", "Create GDPR Request"
Analytics: Added "Get Engagement Filters", "Create Export", "Get Exports", "Get Export"
Added Get Deliverability Summary endpoint to the Inbox API
Added Get ISP Health endpoint to the Inbox API
Added Get, Post, Delete for DMARC domains plus reports for DMARC compliance (broken down by day and domain), change history, failure, report sources, mail sources.
Get, Put, Post child accounts: added subscription and usage fields for Reputation, DMARC, Design, and Analytics.
Inbox: added endpoints Optimizer Summary, Optimizer Results, Start Campaign Diagnostics, and Get Campaign Diagnostics.
Inbox: Campaign Summary now include SPF & DKIM pass percentages.
Added Design get optimizations API.
Added SNDS IP status API.
Modified SNDS APIs to work with inherited keys from parent accounts.
Added ability to create and modify Blacklist profiles.
Added numeric list of monitored blacklists to the Profile Summary API.
Added ability to filter Blacklisted History by Profile ID.
Added SNDS endpoints to Reputation
Added 'tab' element to Inbox ISP Detail response. This shows which Gmail Inbox tab displayed the email.
Added additional search parameters to Design - Get Test Count
Added ability to search Design tests by keyword.
Added completed times for Design tests and individual renderings.
Added external identifiers (external_id) support to Account Services in the Aliases/Child Accounts endpoints.
Added Account Services endpoints for Get Alias(es), Create Alias, Update Alias, and Delete Alias
Added Design - Get Mobile Device HTML endpoints
Added Reputation API endpoints
Added Design API endpoints
Added Analytics API endpoints
Added support for assigning unique IDs to blacklisted items in a profile to easily track history
Added support to query campaigns by X-Header
Added support for GET/PUT/POST/DELETE child account to easily add, edit, or delete child accounts.
Added support for POST child API key to easily generate new API keys.
Merged legacy Attribute Search API into the Campaign Summary call as additional parameters.