REST API and webhooks

Public REST API with multiple API keys and signed webhooks

Register customers from your website, form, or backend with an HTTP call, and receive every change on your server signed with HMAC-SHA256.

Your CRM is no longer a place you need to manually enter data: it becomes an endpoint your systems call.

AiCrm, the CRM app from AIsToHire, exposes a public REST API over your own customers. With an API key in the `X-Api-Key` HTTP header, you can create, list, query, update, and delete customers, and add activities to any of them, from your website form, chatbot, a Zap, a Python script, or your own backend. Responses are JSON in the format `{ success, data }`, and the limit is 100 requests per minute per key.

API registration does not duplicate: if the email you send already exists in your database, AiCrm updates the existing customer record (completes missing phone, name, or company, merges the tags/labels) and logs a new submission in its timeline, returning HTTP 200; if it's new, it creates it and returns 201. Each customer entering via API is automatically tagged as `api-lead`, retains the tags/labels you send, and saves the source `subId`, in addition to the country, IP, and browser from which they arrived.

You can have up to 20 named API keys, in addition to the app's internal key. This way, you give a different key to each integration —the website, the May campaign form, the intern, the vendor— and revoke it individually when that integration ends, without affecting the others. The full value of a key is shown only once, upon creation; afterwards, it is only visible masked in the list.

In the other direction, webhooks notify your systems. You configure up to 10 destinations, choose which events each subscribes to (`customer.created`, `customer.updated`, `customer.deleted`, `activity.created`), and AiCrm performs a POST to your URL with the `X-AiCrm-Event` and `X-AiCrm-Signature: sha256=…` HTTP headers, the HMAC-SHA256 signature of the body with that webhook's secret, so you can verify that the delivery is legitimate. When saving the URL, an anti-SSRF guard rejects localhost, 127.0.0.0/8, 10.x, 192.168.x, 172.16-31.x, ::1, 0.0.0.0, and `.local` and `.internal` domains.

Benefits of REST API and webhooks

Customer registration with a single call

a POST to `/api/apps/public/crm/customers` with the email and any tags/labels you want, and the lead is already classified in your CRM.

No duplicates by design

if the email already exists, the customer record is updated and the new submission is logged in its timeline instead of creating a second record.

Up to 20 named API keys

one per integration, separately revocable. If a key is leaked, you delete only that one, and nothing else stops working.

Webhooks signed with HMAC-SHA256

verify the `X-AiCrm-Signature` HTTP header with your secret to confirm the notification originates from your CRM, not a third party.

Anti-SSRF protection included

the app refuses to deliver webhooks to localhost or private network ranges, preventing your CRM from being used to probe an internal network.

Full CRUD, not just creation

list with pagination and filters (search, lifecycle status, contact tags, country), query a customer with their activity, update, delete, and log activities for them.

Automatically traced origin

each API creation saves the `subId` you send, plus the country, IP, and browser, and is tagged as `api-lead` for later filtering in the app.

Guesswork-free testing

the app includes endpoint documentation with a copyable `curl` example and a button to send a test delivery to each webhook, showing the lifecycle status and time of the last attempt.

Claire Donovan

Connect your website to your CRM this afternoon

AiCrm is AIsToHire's CRM tool that receives your customers via REST API and notifies your systems with signed webhooks. Create your account, generate a key, and make your first call.