The connections to outside systems
https://api.app2email.com/v1/{number}/submit/connections Scope: submissions:manage. The systems automations can call: plain HTTP APIs, APIs described by an OpenAPI document, and MCP servers. Each with its kind, address, sign-in type (has_secret, never the secret), how many operations or tools are known, the last time it worked, its last error and the automations that use it.
Path
-
Your app2email WhatsApp number - the number the message is sent FROM. Full number with country code, digits only.
e.g.4976659348270
Responses
Fields
- success boolean
- request_id string
- connections object[]
13 item fields
- name stringe.g.
ERP - kind string
http: A base address and a sign-in. An http action names the method, path, query, headers and JSON body.openapi: An OpenAPI 3.0 or 3.1 document in JSON (spec_url, or spec posted once; up to 2 MB; YAML and Swagger 2 are not read). app2email keeps a short list of its operations; an openapi action picks one and fills its parameters.mcp: An MCP server on streamable HTTP (base_url) with a token or no sign-in (OAuth and SSE-only servers are not supported). app2email lists its tools; an mcp action picks one and fills its arguments.httpopenapimcp - base_url string
https only. http: the base every path is added to. openapi: the API's base; left empty, the document's first server is used. mcp: the server's address.
e.g.https://erp.example.com/api -
Up to 5 fixed headers sent with every call. Not secret: they are shown again.
e.g.{"X-Tenant":"acme"} - spec_url string
openapi only: where the OpenAPI document (JSON) is read from.
e.g.https://erp.example.com/openapi.json -
false: actions that use it fail without calling out.
- key stringe.g.
erp - auth object
4 fields
- type string
nonebearerheaderbasicquery - name string
- username string
- has_secret boolean
A secret is stored. It is never returned.
- functions_count integer
openapi, mcp: how many operations or tools are known.
- functions_at string (date-time) | null
When they were last read.
- last_ok string (date-time) | null
The last call or test that worked.
- last_error string
- used_by string[]
The names of the automations that use it.
Errors
- 400 The request is malformed (missing or invalid fields, query parameters or times).
- 401 Missing, invalid, revoked or expired API key.
- 403 The key is valid but this call is not allowed: the key lacks the scope the call needs (insufficient_scope), the address is not allowed for the key (ip_not_allowed), the number or plan does not allow it, a recipient opted out or is not opted in, or a problem with the WhatsApp account.
- 404 The number, template, message, broadcast, webhook, delivery, opt-in, logged request, booking or Flow was not found.
- 429 A monthly plan limit, the number's own monthly cap, the key's daily cap, a WhatsApp rate limit, the API rate limit (rate_limited), or the webhook test limit (too_many_tests) was reached. Retry-After and error.retry_after_seconds say how long to wait.
- 500 Unexpected error on app2email's side.
- 503 app2email's connection to the WhatsApp account needs attention, or the request log is not available right now.