API Reference
Coastline REST API
Connect external tools, automation platforms, and AI agents directly to your Coastline workspace. The API is a standard REST interface that speaks JSON over HTTPS and authenticates with a bearer token. Subscribe to webhooks to receive event callbacks whenever data changes in your workspace.
Base URL
All requests go to:
Authentication
Every request must include an Authorization header with a valid API key. Create and manage keys in Settings → API Keys. Keys begin with ck_live_ and are shown only once at creation time.
Keys are scoped to the workspace they were created in and inherit full admin privileges. Only admins can create keys.
Errors
Errors return a standard JSON shape with an HTTP status code. Possible codes:
| Status | Code | Meaning |
|---|---|---|
| 400 | validation_error | The request body is malformed or missing required fields. |
| 401 | unauthorized | The API key is missing, invalid, or revoked. |
| 403 | forbidden | The key does not have permission to perform this action. |
| 404 | not_found | The resource does not exist. |
| 500 | internal_error | Something went wrong on our end. Retry safe. |
Quick start
- Go to Settings → API Keys and create a key.
- Copy the key. You'll only see it once.
- Send your first request (see the right panel).
- Browse the Contacts reference for available endpoints.
Connect with Zapier
Zapier connects Coastline to thousands of other apps with no code. Push new leads, contacts, tasks, and notes into your workspace from the tools you already use, and start a Zap whenever something changes in Coastline.
- Create an API key in Settings → API Keys. Treat it like a password: anyone with the key can read and write data in your workspace.
- In Zapier, search for the Coastline CRM app and add it. When Zapier prompts you to sign in, paste the API key you just created to authorize the connection.
- Build your Zap. Pick a trigger (a Coastline event such as New Opportunity or Estimate Approved, or an event from another app like a form submission), then choose a Coastline action such as Create Contact or Create Task.
Prefer to wire things up yourself? The same triggers are available to any HTTP client. See the webhooks reference to subscribe directly from Make, n8n, or your own backend.