Developers

Programmatic direct mail.
Full API. Real webhooks.

Direct mail integrated into the marketing stack the way every other channel already is. Full-coverage REST API for every platform function. Webhook events on every meaningful lifecycle moment. Per-account scoped keys with audit logging. SOC 2 Type 2 certified infrastructure. SDKs for the major server languages. The integration that took six months on a legacy direct mail vendor takes weeks on DirectMail.io.

Integration surfaces

Four ways into the platform.

REST API

Full-coverage. Bearer token auth.

Every function exposed in the platform UI is also callable through the REST API. Create campaigns, push lists, launch sends, query analytics, manage suppressions, configure templates. The API is the same surface the UI itself runs against.

Webhooks

Lifecycle events. Signed payloads.

Subscribe to drop launched, mail-piece scanned (origin, NDC, SCF, DDU), Predicted Delivery Window updated, email sent / opened / clicked / bounced, SMS sent / delivered / clicked, landing-page visited, form submitted, conversion captured. Retry-on-failure for 24-48 hours; signed payloads for verification.

SFTP

Bulk file transfer. PGP supported.

Per-account SFTP credentials with key-pair authentication. Files route into list ingest, suppression updates, campaign launches, or custom downstream workflows by directory or filename pattern. CSV, TSV, JSON Lines, Parquet, Excel formats supported.

SDKs

Python, Node.js, Ruby, PHP.

Official SDKs for the major server languages. Authentication, pagination, retry logic, and webhook signature verification handled automatically. Other languages work directly against the REST API; OpenAPI specification available for SDK generation.

Common integration patterns

What teams build with the API.

  • CRM-triggered campaign launches

    Sales or service events in Salesforce, HubSpot, or your custom CRM trigger direct mail campaigns automatically via API. Onboarding mail, lifecycle nudges, win-back campaigns all fire from the source system without manual list export.

  • BI and data warehouse integration

    Webhook events stream to Snowflake, BigQuery, or Redshift for full-fidelity attribution. Direct mail joins the rest of the marketing data warehouse instead of living in a campaign-tool silo.

  • Custom analytics dashboards

    Internal analytics teams build campaign-specific dashboards in Looker, Tableau, Power BI, or custom tools using API queries. The platform dashboards stay the default; custom views serve specialized stakeholder needs.

  • Marketing automation orchestration

    Marketo, Eloqua, or HubSpot Marketing Hub orchestrates multi-channel campaigns where direct mail is one of several coordinated touches. The marketing automation tool fires the mail launch; the platform handles production and reports back via webhook.

Documentation status

Reference docs by request.

Full per-endpoint reference documentation, webhook payload schemas, code samples across all supported SDKs, and the OpenAPI specification are available to authenticated developer accounts. Public-facing reference documentation is being expanded; for the current state, request access at developers@directmail.io.

Sandbox access for evaluation typically provisions within one business day. Production credentials issue with the standard onboarding workflow.

Developer FAQ

Questions developers ask first.

Short answers. For integration scoping calls, request access through the contact above and we’ll walk through your specific use case.

  • How do I get API access to DirectMail.io?

    API access provisions on every paid platform account. To request developer access for evaluation, integration scoping, or vendor security review, email developers@directmail.io with your company name, the integration use case, and a preferred timeline. Sandbox access for evaluation can typically be set up within one business day.

  • Where is the full API reference documentation?

    Per-endpoint reference documentation, webhook payload schemas, code samples, and the OpenAPI specification are available to authenticated developer accounts. Public-facing reference documentation is being expanded; for the current state, request access through the contact above and the developer relations team will provide the relevant documentation for your integration scope.

  • What does the API rate limit look like?

    Rate limits are generous for production use; most legitimate integrations never see them. Higher-volume use cases (bulk record push, high-frequency event polling) configure with elevated rate limits per program. The platform reports rate limit headers on every response so client systems can self-manage their request cadence.

  • Are there official SDKs?

    Python, Node.js, Ruby, and PHP have official platform SDKs. SDKs handle authentication, pagination, retry logic, and webhook signature verification automatically. Other languages can integrate directly against the REST API using standard HTTP libraries; the OpenAPI specification supports SDK generation in any language.

  • How do webhook signatures work?

    Every webhook delivery includes a signature header generated from the payload and your account's shared secret. SDKs verify the signature automatically; manual verification follows a documented HMAC-SHA256 pattern. Verification ensures the webhook actually originated from the DirectMail.io platform and the payload was not modified in transit.

  • Is the platform infrastructure SOC 2 Type 2 certified?

    Yes. The full platform infrastructure including the API and webhook delivery layer is covered by the SOC 2 Type 2 certification. The attestation report is available under NDA through security@directmail.io. API integrations inherit the platform security posture (encryption in transit, audit logging, access control) without additional configuration.

  • Can we use both the API and SFTP?

    Yes. The two integration patterns are complementary. SFTP handles bulk file transfer (large list ingest, recurring exports, system-to-system batch moves). API handles per-record real-time operations (single-record lookups, individual campaign launches, real-time event posts). Most production programs use both.

Get developer access.

Email developers@directmail.io with your company, the integration use case, and a preferred timeline. Sandbox access provisions within one business day.