n8n

Connect

1. In meruma, Integrations › For developers › Create app: pick the permissions and copy the ID and secret.

2. In n8n, create an OAuth2 API credential with:

   • Grant Type: Client Credentials
   • Access Token URL: https://api.meruma.app/oauth/token
   • Client ID and Client Secret: the app’s

   n8n requests the token itself and renews it when it expires.

3. An HTTP Request node with that credential reads or writes. For example, POST https://api.meruma.app/v1/contacts/upsert with a JSON body to create or update a contact. Add the Idempotency-Key header and nothing is duplicated if n8n retries.

Every route, with its parameters, is in the API reference.

Receive events

1. In n8n, add a Webhook node and copy its production URL.
2. In meruma, Integrations › For developers › Webhooks, create a webhook with that URL and the events you want. Owners and admins create them.
3. To check that the event comes from meruma, compare the signature with the webhook’s secret: see Verify the signature.