What is the SMOC REST API and how do I connect it?
Category: Data Integrations
The SMOC REST API is a company-scoped HTTP API on https://v2.api.smoc.ai. Customer keys are read-only by default; write-enabled keys may call limited writes including inbox send. Generate a key in Console under Settings → Integrations → API. Use POST /api/v2/{toolName} for domain tools, or GET /api/company/mongocontact for the Zapier/compat contacts contract.
Setup summary:
- Copy the key immediately — it is shown only once. You can optionally name it and set an expiry. Issued keys are listed on the same page so you can revoke unused ones.
- Call GET https://v2.api.smoc.ai/api/company/mongocontact with the token header (not Authorization: Bearer).
- Optional query parameters: limit (1–500, default 100) and sortByField (createdAt, updatedAt, or lastConversationDate).
Step-by-step setup is in the REST API eGuide.