Quickstart

By the end of this page you will have pulled a call summary from your workspace and received a signed test event at a URL you control.

Before you start

You need to be an admin of your TrailerCast workspace (the same permission that connects HubSpot or Salesforce).
The API must be enabled for your workspace. If Settings → Integrations has no API access section, it is not on yet — ask hello@trailercast.io.
For the webhook half you need an HTTPS URL that can receive a POST. For a quick experiment, a request bin or a tunnel to your laptop is fine.

Create an API key

Open Settings → Integrations → API access and click Create key. Give it a name that says which system will hold it — “HubSpot sync”, “Snowflake loader” — and click Create.

The key is shown once. Copy it into your secret store before closing the dialog. Only a hash is kept on our side; if you lose it, revoke it and create another.

Keys look like tck_live_ followed by 43 URL-safe characters. Your API host is shown on the same screen.

Confirm the key works

curl https://YOUR_HOST/api/v1/status \
  -H "Authorization: Bearer tck_live_…"

const res = await fetch('https://YOUR_HOST/api/v1/status', {
  headers: { Authorization: `Bearer ${process.env.TRAILERCAST_API_KEY}` },
});
console.log(await res.json());

import os, requests
r = requests.get(
    "https://YOUR_HOST/api/v1/status",
    headers={"Authorization": f"Bearer {os.environ['TRAILERCAST_API_KEY']}"},
)
print(r.json())

Response

{
  "ok": true,
  "apiVersion": "2026-09-01",
  "company": { "id": 5, "name": "Acme" },
  "key": { "prefix": "tck_live_Ab1", "name": "HubSpot sync", "scopes": ["read"], "createdAt": "…", "lastUsedAt": null },
  "webhooks": { "endpoints": 0, "enabledEndpoints": 0, "pendingDeliveries": 0, "deadDeliveries": 0, "lastDeliveredAt": null },
  "rateLimit": { "perMinute": 300 }
}

company.id is your workspace. Everything the key returns belongs to it.

Pull your most recent calls

curl "https://YOUR_HOST/api/v1/calls?has_summary=true&limit=5" \
  -H "Authorization: Bearer tck_live_…"

Each item in data is a Call with a normalised summary. Note the nextCursor in the response — pass it back as ?cursor= to page, and store it to pick up only what changed next time. See Pagination.

Back on Settings → Integrations → API access, under Webhook endpoints click Add endpoint. Enter your HTTPS URL, leave All events selected, and click Add.

The signing secret (whsec_…) is shown once. Store it next to your key — you need it to verify every delivery.

Send yourself a test event

Click Send test on the endpoint. TrailerCast POSTs an integration.ping to your URL immediately and shows the response code it got back. A 2xx means you are receiving deliveries.The request carries an X-TrailerCast-Signature header. Before you act on any real event, verify that signature — it is the only thing that proves the request came from TrailerCast.

Next steps

Syncing a CRM

The backfill → incremental → webhook pattern, and how TrailerCast objects map to deals, contacts, and activities.

Webhook events

What each event type carries and when it fires.

Rate limits

300 requests a minute per key, and how to stay under it while backfilling.

OpenAPI spec

Import into Postman, Insomnia, or a client generator.

Get started

Working with data

Webhooks

Endpoints

Management (admin session)

Reference

Before you start

Next steps

Syncing a CRM

Webhook events

Rate limits

OpenAPI spec

​Before you start

​Next steps

Syncing a CRM

Webhook events

Rate limits

OpenAPI spec

Before you start

Next steps