Skip to main content
API Reference

AngelSend API documentation

Complete reference for all API endpoints with code examples in cURL, JavaScript, and Python.

Auth

Authentication

AngelSend has three authentication patterns. Generate the relevant credentials from your Settings page.

01External integrations — /api-gateway/*

For partner apps, agents, and third-party tools (also /mcp-server and /agent-api). Send your sk_ key in the x-api-key header; Authorization: Bearer sk_… also works on these three routes. Never send an anon or user JWT to them.

bash
x-api-key: sk_your_api_key_here

02External OAuth app endpoints

Endpoints like external-calendar-api/* are for apps you register in Settings → External Apps. Use the app's client_secret in the x-api-key header. General sk_ project API keys do not work on these routes.

bash
x-api-key: secret_your_external_app_client_secret

03First-party / logged-in user endpoints

All other endpoints require a Supabase user JWT (Bearer token) — typically obtained automatically via the AngelSend client SDK when a user is signed in.

bash
Authorization: Bearer <user_jwt>

Which one do I use? If the endpoint path starts with /api-gateway/, use x-api-key. Everything else uses a Bearer JWT. If it starts with /external-calendar-api/, use the External App client_secret in x-api-key. Endpoints like cred-api are internal-only and cannot be called with an sk_ key — use /api-gateway/get-credit-balance instead for external balance reads.

Debugging

Auth Troubleshooting

ErrorCauseFix
401 Missing authorization headerCalling a first-party endpoint without a Bearer JWT.Add Authorization: Bearer <user_jwt>, or switch to the /api-gateway/* equivalent.
401 invalid JWT … invalid number of segmentsPassing your sk_ key as a Bearer token to a first-party endpoint (only /api-gateway, /mcp-server and /agent-api accept it there).Move sk_ to x-api-key and target an /api-gateway/* route.
401 invalid claim: missing sub claimCalling an internal user-scoped endpoint (e.g. cred-api) without a real user session.Use the external equivalent, e.g. /api-gateway/get-credit-balance.
401 Invalid API keyWrong key type, revoked key, mistyped key, or a key from a different AngelSend workspace/environment.For /api-gateway/*, use your sk_ project API key. For external-calendar-api/*, use the registered External App client_secret from Settings → External Apps.
503 Temporarily unable to verify the API keyAngelSend couldn't reach its database to check the key. It says nothing about the key itself.Retry after the Retry-After seconds, with backoff. Don't discard or rotate the key — only a 401 means it's bad.
Base URL

Base URL

text
https://invazkujqgdgpkpsingh.supabase.co/functions/v1

Authentication

1 endpoint

Agent Chat (Agent-as-API)

1 endpoint

External API Gateway

12 endpoints

Contacts & Leads

12 endpoints

Email Campaigns

11 endpoints

LinkedIn Outreach

3 endpoints

Voice Agents

12 endpoints

AI Chat Widget

6 endpoints

Booking & Calendar

5 endpoints

Calendar Slotting

2 endpoints

Slack Integration

1 endpoint

Salesforce / HubSpot Sync

2 endpoints

Outbound Webhooks

9 endpoints

Deals (Pipeline)

5 endpoints

Accounts (Companies)

4 endpoints

Segments

2 endpoints

Tags, Comments & Attachments

3 endpoints

Compliance

6 endpoints

Background Jobs

2 endpoints

CRM Integrations

9 endpoints

AI & Reply Handling

5 endpoints

Scraping & Automation

4 endpoints

Analytics

1 endpoint

Credits

4 endpoints

External App OAuth

16 endpoints

Partner Email (External Apps)

5 endpoints

OAuth Provider System

6 endpoints

Embed Forms

2 endpoints

Contact Intelligence

6 endpoints

Market Intelligence

1 endpoint

Quality & Advisory

4 endpoints

Campaign Authoring

16 endpoints

Per-Recipient Campaign Controls

6 endpoints

Sender Limits & Warm-up

2 endpoints

Messaging & Knowledge Base

8 endpoints

Inbox

4 endpoints

Intent Signals

2 endpoints

Contact Form Outreach

2 endpoints

Intercom Widget Management

16 endpoints

Reporting & Metrics

7 endpoints

Campaign & Contact Records

8 endpoints

Review Queue & Support

6 endpoints

Platform State & Automation

13 endpoints

Issuer Funnel

11 endpoints
Limits

Rate Limits

  • Default: 1000 requests per hour per API key
  • Burst: 100 requests per minute
  • Rate limit headers are included in all responses
Errors

Error Codes

400
Bad Request - Invalid parameters
401
Unauthorized - Invalid or missing API key
402
Payment Required - Insufficient credits
429
Too Many Requests - Rate limit exceeded
500
Internal Server Error
503
Service Unavailable - Temporary; retry after Retry-After. Your key is still valid