What is the SMOC REST API and how do I connect it?

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.