AIMERICAAPI · Developers

Zapier

No AIMERICA app in the Zapier directory yet: a webhook and a key are all it needs.

Triggers (something happens in AIMERICA → a Zap runs)

  1. In Zapier, start a Zap with Webhooks by Zapier → Catch Hook and copy the address it gives you.
  2. In the app, Settings → Developer → Webhooks (first generation): paste the address, tick the events (a missed call, a new voicemail, a received text…), Save, then Test. Zapier receives the ping; the fields of every later event are under data.
Why the first generation: /v1/webhooks subscriptions require the handshake (echoing X-AIMERICA-Validation-Token), which a Zapier Catch Hook cannot do. The addresses under Settings → Developer have no such requirement, and their signature verifies the same way.

Actions (a Zap does something in AIMERICA)

Add a step Webhooks by Zapier → Custom Request to any route of the v1 API, with a key that carries only the scope needed (for instance messages:write alone for a Zap that sends texts):

Method   POST
URL      https://api.a1merica.ai/v1/messages
Headers  Authorization: Bearer aim_live_…
         Content-Type: application/json
Body     {"from": "+16135550101", "to": ["+15145550100"], "text": "Your appointment is confirmed for 3 pm."}

The same recipe works with Make, n8n, Power Automate and any tool that can catch a webhook and send an HTTPS request.