Developers
API and MCP
Three ways to work with Sendability from code: the Verify API for email validation, your AI agents through MCP, and the Mautic REST API of your own instance.
Sendability Verify API
Email validation, one address at a time or a whole file.
Base URL
https://verify.sendability.com/api/v1AuthenticationHeader X-API-Key. Keys that cover several companies also send company_id or the 4-letter company_code.
Full referenceverify.sendability.com/api-docs
| Method | Path | What it does |
|---|---|---|
| POST | /validate/single | One address. Body: email, optional company_id, optional force_revalidate. Returns status (Valid, Invalid or Greylist), raw_status, source, cached and date_last_validated. |
| POST | /validate/file | A CSV file in the multipart field "file". Returns job_id, status and total. |
| GET | /jobs/{job_id} | Progress of a file job: status (Pending, Processing, Done or Error), progress, total and processed. |
| GET | /jobs/{job_id}/download | The validated file as CSV. |
| GET | /companies | The companies your key can validate for. |
| GET | /reports/summary | Billed, valid, invalid and greylist counts between start_date and end_date. |
| GET | /contacts | Validated contacts, paginated, up to 1,000 per page. |
curl -X POST https://verify.sendability.com/api/v1/validate/single \
-H "X-API-Key: $SENDABILITY_VERIFY_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "someone@example.com"}'MCP for your AI agents
Connect Claude or any MCP client to your Mautic: contacts, segments, emails and campaigns. Sends and deletions ask for your confirmation through a link.
Endpoint
https://mcp.datainnovation.io/mcpTransportStreamable HTTP
AuthenticationOAuth 2.1 authorization code with PKCE (S256) and dynamic client registration. Scopes: mautic:read, mautic:write, mautic:delete.
AccessEnabled per user by our team. Ask for it from the contact page.
claude mcp add --transport http sendability https://mcp.datainnovation.io/mcpMautic REST API
Every Sendability client has its own Mautic instance with the standard Mautic REST API: Basic authentication with your login, or OAuth2 client credentials.