Overview

Getting Started

The trumpet API lets you programmatically create Pods from your CRM data. This guide walks you through creating an account, generating an API key, and making your first request.

1

Create a trumpet account

If you don't already have one, sign up for an account at trumpet.app. You'll need an active brand with an admin role to generate API keys.

2

Generate an API key

Navigate to Settings → API Keys in your trumpet dashboard. Click Create Key, give it a descriptive name, and select the scopes you need.

🔒

Store your key securely

Your API key is only shown once at creation. Copy it immediately and store it in a secrets manager or environment variable. You will not be able to retrieve it again.
3

Connect your CRM

The API creates Pods from CRM records, so you need at least one CRM integration connected to your brand. Go to Settings → Integrations and connect one of the supported CRMs: HubSpot, Salesforce, ActiveCampaign, Pipedrive, Brevo, MS Dynamics, or SugarCRM.

4

Make your first request

Once you have a key and a connected CRM, you can create a Pod:

cURL
curl -X POST https://trumpet.app/api/v1/pods/new \
  -H "Authorization: Bearer trpt_a1b2c3_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "crm_type": "hubspot",
    "crm_object": "deals",
    "crm_id": "12345",
    "template_id": "tpl_abc123"
  }'

Base URL

All API requests are made to the following base URL:

https://trumpet.app/api/v1

Rate Limits

The API is rate limited on a per-endpoint basis. If you exceed the limit, you'll receive a 429 Too Many Requests response. The response headers include X-RateLimit-Remaining and X-RateLimit-Reset so you can pace your requests.

Error Format

All errors return a consistent JSON shape:

Error Response
{
  "success": false,
  "error": "A human-readable description of what went wrong"
}