RapidPro icon

RapidPro

Send SMS and WhatsApp messages, manage contacts, trigger flows, and broadcast alerts via RapidPro.

Actions13

Contact → Create

AI-generated

Summary

Create a RapidPro contact by sending a POST request to /contacts.json with the contact’s URN and any supplied details. The operation normalizes phone numbers to a tel: URN when needed, then returns the API response as an n8n output item.

Inputs

  • Phone Number (URN) (required) — Contact phone number or URN. Accepts a number such as +250788123456, a tel: URN, or a whatsapp: URN. Plain numbers are sent as tel: URNs.
  • Name — Full name; included only when provided.
  • Language — ISO 639-3 language code, such as eng, kin, swa, or fra; included only when provided.
  • Groups — Optional list of group UUIDs to add to the contact.
  • Custom Fields — Optional key/value pairs for custom fields that already exist in RapidPro. Entries without a key are omitted.

Output shape

The RapidPro API response as one n8n item.

The request sends the URN in an urns array. Optional name, language, groups, and custom fields are included only when supplied. With Continue On Fail enabled, an error is returned in an item’s error field.

Links

Discussion