# Platform API

Build on the Instasent Platform — a CDP for mass marketing — from your own code: the Product API and the Ingest API, authentication, OAuth for connected apps, and docs ready for AI agents.

**Language:** en
**Audience:** developer
**TLDR:** The Platform API is the API of the Platform, Instasent's CDP for mass marketing: the Product API (the unified audience plus organizations, projects, campaigns, flows and analytics) and the Ingest API (high-volume contact and event ingestion per datasource). Sending from your own code without an audience is the other product, the A2P Messaging API (self-service messaging for applications and AI agents), under /a2p-messaging-api. Docs ship as markdown with llms.txt indexes; agents connect via MCP and OAuth.
**Docs index (every page):** https://docs.instasent.com/llms.txt
**This page:** https://docs.instasent.com/platform-api/overview/ (HTML) · https://docs.instasent.com/platform-api/overview.md (Markdown)

- [Product API quickstart](/platform-api/product-api/quickstart)
- [Create an account](/platform-api/getting-started/create-an-account)
- [API Reference](/platform-api/product-api/reference)

#### curl

```bash
BASE="https://api.instasent.com/v1/project/$INSTASENT_PROJECT"

curl "$BASE/audience/search/phone/%2B34600000000" \
  -H "Authorization: Bearer $INSTASENT_TOKEN"
```

#### node

```js
const base = `https://api.instasent.com/v1/project/${process.env.INSTASENT_PROJECT}`;
const res = await fetch(`${base}/audience/search/phone/%2B34600000000`, {
  headers: { Authorization: `Bearer ${process.env.INSTASENT_TOKEN}` },
});
const { entity: contact } = await res.json();
```

#### python

```python
import os, requests

base = f"https://api.instasent.com/v1/project/{os.environ['INSTASENT_PROJECT']}"
res = requests.get(
    f"{base}/audience/search/phone/%2B34600000000",
    headers={"Authorization": f"Bearer {os.environ['INSTASENT_TOKEN']}"},
)
contact = res.json()["entity"]
```

#### ✦ Your AI

```text
Read https://docs.instasent.com/llms.txt and, with the Instasent Product API,
find the contact with phone +34600000000 in my project and show me their last events.
My project is in $INSTASENT_PROJECT and my token in $INSTASENT_TOKEN.
```

## Getting started

- [Give the docs to your AI](/platform-api/further-reading/use-with-ai#drop-in-prompt-for-any-agent) - The shortcut: one prompt to copy into your assistant, and it reads the rest for you.
- [Introduction](/platform-api/getting-started/introduction) - The map: what each API does and how they fit together.
- [Choose your API](/platform-api/getting-started/choose-your-api) - A decision guide to pick the right surface for your use case.

## The APIs

- [Product API](/platform-api/product-api/guide) - The CDP API — Instasent's Customer Data Platform: the unified audience and the control plane around it (organizations, projects, datasources, campaigns, analytics).
- [Ingest API](/platform-api/ingest-api/guide) - High-volume ingestion of contacts and events, scoped to a single datasource.

## The other product: the A2P Messaging API

Instasent has two products, and both have APIs. This zone documents the
Platform's, a CDP for mass marketing. The other one, the **A2P Messaging API**,
is self-service messaging for applications and AI agents: to send from your own
code — OTPs, receipts, bulk sends — to phone numbers you manage yourself, with
no audience in Instasent, use it. It has its own project type and its own
documentation.

- [A2P Messaging API](/a2p-messaging-api/overview) - Direct messaging over HTTP or SMPP, with delivery reports and SDKs for Node.js, PHP, Python, Ruby and Java.
- [Which API do I need?](/platform-api/getting-started/choose-your-api) - Product API or A2P Messaging API: the decision by use case.

## Use with AI

These docs are built for LLM consumption: every page ships as plain markdown,
each API as a single paste-ready dump, and your agents can operate Instasent
directly over MCP and OAuth.

- [Use with AI](/platform-api/further-reading/use-with-ai) - The map: llms.txt indexes, per-API dumps, markdown twins and a drop-in prompt for any agent or IDE.
- [Connected apps (OAuth)](/platform-api/product-api/connected-apps-and-oauth) - Let AI agents and third-party apps operate a project with scoped, revocable access.
- [llms.txt](/llms.txt) - The machine-readable index of every page — hand it to your assistant.

## Guides

- [Creating campaigns](/platform-api/product-api/campaigns/creating-a-draft) - Build a campaign draft from code and hand the send off to a human.
- [Building analytics queries](/platform-api/product-api/analytics/building-queries) - Query performance, conversions and audience growth from code.

## Resources

- [Product API reference](/platform-api/product-api/reference) - Every endpoint, generated from the OpenAPI spec.
- [A2P Messaging API reference](/a2p-messaging-api/http/reference) - The HTTP messaging endpoints in full detail.
- [Query Filter](/platform-api/further-reading/query-filter) - Filter, sort and paginate the Product API's list endpoints.

---

This is one page of the Instasent documentation. For the complete machine-readable index of every guide and API reference, fetch https://docs.instasent.com/llms.txt — start there for full context.