Async API Overview

The Async API is a single-purpose interface for ingesting leads at high volume. Requests are accepted, queued, and processed in the background — the response confirms receipt only, not the outcome of the create or update.

When to use the Async API

The Async API is the right choice for ingesting leads from sources where the response does not drive any decision flow:

• Website and landing-page forms
• Ad platform webhooks (Facebook, Google, LinkedIn)
• Third-party integrations pushing leads into telecrm
• Batch jobs and bulk uploads

For interactive flows that need confirmation of each operation — or for any read, search, or non-lead resource — use the Sync API instead.

Characteristics

• Fire-and-forget. A 200 response means the request was queued, not that the lead was successfully created or updated.
• Lead-only. The Async API exposes a single endpoint: create-or-update a lead. It cannot read, search, or operate on actions/team members/metadata directly.
• High throughput. 18,000 requests per hour per token.
• Cost-efficient. Designed for bulk ingestion at the lowest cost per request.

Behavior

• Leads are matched against the workspace's lead identifier. A matching lead is updated; otherwise a new lead is created.
• Existing fields not present in the request are left unchanged on update.
• Any actions in the request are appended to the lead's timeline in the order provided.
• Validation failures during background processing are not surfaced to the caller. Misconfigured payloads can result in silently dropped fields or actions — see Pitfalls.

Endpoint

Method	URL
POST	https://next-api.telecrm.in/enterprise/{enterpriseId}/autoupdatelead

See Create or Update Lead for the full reference.

Authentication

Every request must include an Async-typed bearer token in the Authorization header. Sync tokens are rejected with 401 NOT_AUTHORIZED. See Authentication.

Limits

• Rate limit: 18,000 requests/hour per token. Exceeding the limit returns 429.
• Token cap: maximum 3 Async tokens per workspace.