Developer API Reference

Integrate InkCourier into your systems to send handwritten cards programmatically.

Authentication

All API requests require authentication using an API key. Create one in your Dashboard → API Keys.

Base URL

https://api.inkcourier.com/api/v1

Request Header

X-Api-Key: ink_YOUR_API_KEY

Security: Keep your API keys secret. Never expose them in client-side code. Rotate keys immediately if you suspect compromise.

Create and manage handwritten card orders. Orders are queued and processed automatically.

Browse available card designs. Cards are organized by category and include pricing.

Browse available handwriting styles for your cards.

Save and manage recipient and sender addresses for quick reuse.

Send multiple cards at once using CSV upload. Perfect for campaigns and batch sending.

Tip: Download the template first to see required column headers. Always validate your CSV before uploading to catch errors early.

All errors return a consistent JSON format with an error message and optional details.

{
  "error": "Validation failed",
  "details": {
    "recipientZip": "Invalid ZIP code format"
  }
}

Code	Description
`200`	Success
`201`	Created successfully
`400`	Bad request / Validation error
`401`	Unauthorized / Invalid API key
`403`	Forbidden / Plan limit exceeded
`404`	Resource not found
`429`	Rate limit exceeded
`500`	Internal server error

API requests are rate-limited to ensure fair usage and system stability.

Limit	Value
Requests per 15 minutes	500

Rate limit info is returned in response headers: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset

InkCourier integrates with popular CRM and automation platforms.

Zapier

Connect to 5,000+ apps

HubSpot

Coming soon

Salesforce

Coming soon

Pipedrive

Coming soon

Need help with your integration? We're here to assist.