Welcome to the Posta API reference documentation. Our API empowers businesses to automate physical mail at scale with unparalleled efficiency and security. The Posta API offers intuitive, resource-oriented endpoints that accept and return JSON-formatted data, utilizing standard HTTP methods and response codes.

Authentication

Secure your API requests with Posta

Versioning

Understanding Posta’s API versioning system

Pagination

Efficiently retrieve large sets of data

Idempotency

Safely repeat API requests without side effects

Rate limiting

Manage your API request volume

Metadata

Enhance your Posta API objects with custom metadata

Errors

Understanding and handling Posta API errors

​
API Playground

To help you get familiar with our API, we provide an interactive API playground for each endpoint. You can test requests, see responses, and generate code snippets in various languages directly from our documentation. Look for the “Try It” button throughout our API reference pages.

​
Security and compliance

At Posta, we prioritize the security and compliance of your data.

SOC 2 Type II

Certified for operational excellence and data protection.

HIPAA

Compliant with healthcare data privacy and security standards.

ISO 27001 (soon)

Certification for information security management.

For more information on our security practices and compliance certifications, visit our Trust center.

​
Upcoming features

  • Webhooks: Real-time updates about your mailings and other relevant events.
  • Postman collection: A comprehensive collection of our API endpoints for easy exploration and testing.

​
Need help?

We’re here to support you succeed with Posta.

API status

Check our API status page for current operational status.

Documentation

Explore our extensive API documentation for detailed guides and examples.

Community

We’re working on setting up a developer community. Check back soon for more information.

This documentation is regularly updated to reflect the latest features and improvements in the Posta API. We encourage you to check back often for the most up-to-date information.

Last updated:

Authentication