NewPartner Payouts & Commissions: commission calculated, invoice generated, partner paid.See how it works
Use CasesPricing
Public API

Build on Airstride

Read and write everything in your workspace: partners, deals, account mappings, organisations, users and webhooks. Push partner data into your warehouse, register deals from your own portal, or wire Airstride into whatever your revenue team already runs on.

Base URLhttps://app.airstride.ai/api
Overview

Built for the person integrating it

A REST API with the boring parts done properly, so your integration keeps working after you have moved on to something else.

Key-based authentication

Generate a key in workspace settings and send it in the X-API-Key header. Keys are scoped to your organisation, and you can list, create and revoke them through the API itself.

Date-based versioning

Pin your integration with the Airstride-Version header, the same way Stripe does it. Deprecated versions keep working and announce themselves in the response headers, so you migrate when it suits you.

OpenAPI 3.1.1 and a live reference

The whole surface is described by a spec you can download and generate clients from. The hosted reference lets you send a real request from the page and copy the snippet in Shell, Ruby, Node.js, PHP or Python.

Predictable errors and rate limits

Standard HTTP status codes with a JSON body carrying error and message. Every response reports X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset, so backing off is a header read rather than a guess.

Quick start

Three steps to your first request

Nothing to install and no OAuth dance. A key and a version header is the whole setup.

1

Go to Workspace Settings, then API Keys, and create a key. Copy it straight away. The token is only shown once.

X-API-Key: sk_live_...
2

Pin the version. If you leave the header off, you get the oldest supported version, which is rarely what you want.

Airstride-Version: 2026-03-01
3

Call an endpoint. Start with your partner list to confirm the key and version are both good.

curl https://app.airstride.ai/api/partners \
  -H "X-API-Key: sk_live_..." \
  -H "Airstride-Version: 2026-03-01"
Endpoints

Seven groups, the full lifecycle

From sourcing and mapping through to deal management and event delivery. Every endpoint, its parameters and a runnable example live in the reference.

Partners

6 endpoints

Create, update and enrich partner records, then filter the ecosystem by tier, region, fit score or any field you sync from your CRM.

  • GET /partners
  • POST /partners
  • POST /partners/filter

Deals

6 endpoints

Register co-sell deals, move them through stages, and patch status as your CRM changes. This is the group most integrations start with.

  • GET /deals
  • POST /deals
  • PATCH /deals/{id}/status

Account Mapping

13 endpoints

Kick off a mapping run from a CSV or a CRM sync, read the overlapping and net-new accounts, and manage the history of every run.

  • POST /account-mapping
  • GET /account-mapping/mapped
  • GET /account-mapping/history

Webhooks

9 endpoints

Subscribe to events instead of polling. Verify a subscription, inspect delivery attempts, and retry any delivery that failed.

  • POST /webhooks/subscriptions
  • GET /webhooks/deliveries
  • POST /webhooks/deliveries/{id}/retry

Organizations

5 endpoints

Read and update your organisation profile, list members and invitees, and invite new people. The API key decides which organisation you are acting on.

  • GET /auth/orgs/{id}
  • POST /auth/invite-user

Users

4 endpoints

View and update user profiles, change a person's role, and remove access when someone leaves.

  • GET /auth/users/{id}
  • POST /auth/users/{id}/role

Authentication

3 endpoints

Manage the API keys themselves. Rotate a key on a schedule, or issue a separate key per integration so you can revoke one without breaking the rest.

  • GET /api-keys
  • POST /api-keys
  • DELETE /api-keys/{api_key_id}
Webhooks

Get told, instead of asking

Subscribe an endpoint of yours to the events you care about. Deliveries are logged with their status, and you can retry any one that failed without replaying the rest.

deal.createdA partner or your team registers a new deal.
deal.updatedAny field on a deal changes, including stage and value.
deal.approvedA registered deal is approved.
deal.rejectedA registered deal is rejected.
deal.deletedA deal is removed from the workspace.
campaign.createdA new partner campaign goes live.
contact.addedA new contact is added to a partner.
Reliability

What happens when things change

Versions have a documented lifecycle, and failures come back in a shape you can branch on.

Version lifecycle

A version is current while it is the one we recommend, deprecated once a newer one ships, and sunset when it stops answering. Deprecated responses carry a Deprecation header and, where one is set, a Sunset date, so a monitor can catch it long before anything breaks.

Current version: 2026-03-01

Error shape

Every failure returns the same JSON body, so one handler covers the lot.

{
  "error": "NOT_FOUND",
  "message": "Resource not found"
}
400Bad request. Invalid parameters, or a version we do not recognise.
401Missing or invalid API key.
403The key is valid but lacks permission for this action.
404The resource does not exist.
409Conflict. The resource already exists.
422The request parsed but failed validation.
429Rate limited. Wait until X-RateLimit-Reset before retrying.
500Something broke on our side.
Next

Where to go from here

The interactive reference has every endpoint with a Try It panel and copyable client code. If you would rather not write an integration at all, the MCP connector puts the same data inside Claude and other assistants, and the native integrations cover Attio, folk, Zoho and the rest of the CRM stack out of the box.