Click2Mail REST API

Name: Click2Mail REST API API
Brand: Click2Mail REST API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentCommunicationsEmail Deliverybasic14 EndpointsREST

For Agents

Send physical mail through Click2Mail — upload documents, attach address lists, submit jobs, and check account credits without leaving an agent workflow.

Quickstart

Get started with Click2Mail REST API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"send a physical letter via click2mail"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Click2Mail REST API API.

Upload print-ready documents and read or delete document records

Create and manage address lists of recipients to be paired with mailing jobs

Compose mailing jobs that bind a document to an address list

Submit a prepared job for printing and dispatch through Click2Mail

GET STARTED

Start building with Click2Mail REST API API

Explore with Jentic

View OpenAPI Document

Use for: I need to send a physical letter via Click2Mail, Upload a PDF document to Click2Mail for a future mailing, Create an address list of recipients in Click2Mail, Submit a prepared mailing job for printing and dispatch

Not supported: Does not handle email, SMS, or fax delivery, and does not generate PDF content from templates — use for Click2Mail document upload, address list, and physical mailing job submission only.

Jentic publishes the only available OpenAPI document for Click2Mail REST API, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for Click2Mail REST API, keeping it validated and agent-ready. Click2Mail provides programmatic print-and-mail — letters, postcards, and direct mail pieces dispatched through the US Postal Service via a REST interface. The API is built around three primary resources: documents that hold the printable content, address lists that hold the recipients, and jobs that combine the two into a physical mailing. Agents can use it to upload a PDF, attach a recipient list, submit the job, and read the account credit balance, all behind HTTP Basic auth.

Use Cases

Patterns agents use Click2Mail REST API API for, with concrete tasks.

★ Programmatic Direct Mail Drop

Send physical mail from a backend system by uploading a document, attaching an address list, creating a job that pairs them, and submitting that job for print and dispatch. Click2Mail handles printing, addressing, and USPS handoff. Standing up a basic flow takes a day or two of integration work, including PDF generation upstream.

Upload a PDF to /documents, create an address list at /addressLists with one recipient, create a job at /jobs that pairs them, then call /jobs/{id}/submit

Compliance and Notice Mailings

Drive compliance-driven mailings (annual privacy notices, regulatory disclosures, debt collection letters) directly from a backend service so that volume changes do not require manual intervention. The /jobs and /jobs/{id}/submit endpoints make the actual dispatch deterministic, and /account/credits lets the system pre-check funding. A working flow takes a few days to harden for production volumes.

Read /account/credits to confirm balance is greater than 1000, then submit each pending job in turn via /jobs/{id}/submit

Address List Maintenance

Keep recipient address lists in Click2Mail aligned with a source-of-truth CRM by creating, updating, and deleting lists from an automation. /addressLists and /addressLists/{id} cover the full lifecycle, which is enough to drive a nightly sync job. Setup is typically under a day.

Replace the contents of address list id 5678 with the latest 250 customers from the upstream CRM via DELETE then POST against /addressLists

Agent-Driven Direct Mail via Jentic

Expose Click2Mail to an AI agent through Jentic so an operator can describe an outcome — 'mail this PDF to these 50 customers tomorrow' — and have the agent compose the right document, address list, job, and submit calls. Jentic isolates the Basic auth credentials and surfaces only the relevant operations for the intent. A working integration takes well under an hour.

Search Jentic for 'send a physical letter via click2mail', load the chained operations, and execute the upload-create-submit sequence for a single recipient

Key Endpoints

14 endpoints — jentic publishes the only available openapi specification for click2mail rest api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/documents

Upload a print-ready document

POST

/addressLists

Create an address list

POST

/jobs

Create a mailing job

POST

/jobs/{id}/submit

Submit a job for print and dispatch

GET

/account/credits

Read account credit balance

GET

/jobs/{id}

Read a single mailing job

POST

/documents

Upload a print-ready document

POST

/addressLists

Create an address list

POST

/jobs

Create a mailing job

POST

/jobs/{id}/submit

Submit a job for print and dispatch

GET

/account/credits

Read account credit balance

GET

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Click2Mail Basic auth credentials are stored encrypted in the Jentic vault. Agents receive scoped execution handles — the username and password never enter the agent context, so a leaked transcript cannot be replayed against the API.

Intent-based discovery

Agents search by intent (e.g., 'send a physical letter via click2mail') and Jentic returns the matching multi-step Click2Mail operations with their input schemas, so the agent can chain document upload, list create, job create, and submit without browsing the reference.

Time to first call

Direct Click2Mail integration: 1-2 days to wire Basic auth, multipart upload, and the four-step job flow. Through Jentic: under 1 hour — search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

PDFMonkey API

Generate templated PDFs ready to be uploaded to Click2Mail

Pair PDFMonkey with Click2Mail when the upstream document needs to be templated and rendered before mailing

Alternative

SendGrid Mail

Email delivery service for digital correspondence

Choose SendGrid when the message can be delivered electronically; Click2Mail is for cases that require physical mail

Alternative

Mailchimp API

Email marketing and automation platform

Choose Mailchimp for digital marketing campaigns; Click2Mail covers regulated or compliance mailings that must be on paper

FAQs

Specific to using Click2Mail REST API API through Jentic.

Why is there no official OpenAPI spec for Click2Mail REST API?

Click2Mail does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Click2Mail REST API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Click2Mail REST API use?

Click2Mail uses HTTP Basic authentication against rest.click2mail.com/molpro. You pass your username and password via the standard Authorization header. Through Jentic, those credentials are stored in the Jentic vault and never exposed to the agent context.

Can I send a physical letter end-to-end with this API?

Yes. Upload a PDF to POST /documents, create recipients via POST /addressLists, bind them with POST /jobs, then call POST /jobs/{id}/submit. Click2Mail handles printing, addressing, and USPS dispatch from there.

Can I check my account balance before submitting jobs?

Yes. GET /account/credits returns the remaining credit balance, which is the right pre-check before a bulk /jobs/{id}/submit call to avoid mid-batch failures.

What are the rate limits for the Click2Mail REST API?

Click2Mail does not document fixed numeric rate limits in the public spec. In practice, document uploads are the slowest call (multipart payloads up to several MB), so cap concurrency to a handful of parallel uploads per account.

How do I send a letter through Jentic?

Run pip install jentic, search for 'send a physical letter via click2mail', load the document upload, address list create, job create, and job submit operations in sequence, and execute them. Jentic handles the Basic auth header on every call.