Actions56
- Agent Actions
- Agent Tool Actions
- Call History Actions
- Campaign Actions
- Catalogue Actions
- Catalogue Item Actions
- Contact Actions
- Contact List Actions
- Event Actions
- Order Actions
- Wallet Actions
- Workflow Actions
Contact List → Add Contacts
AI-generatedOverview
This node operation adds contacts to a specified contact list in the Yourang system. It supports adding contacts by their unique contact IDs or by phone numbers in E.164 format. Additionally, it can automatically create new contacts for phone numbers that do not already exist in the system if the 'Auto Create' option is enabled. This operation is useful for managing and updating contact lists dynamically, such as adding new customers or leads to a marketing or communication list.
Use Case Examples
- Adding multiple existing contacts to a contact list by specifying their contact IDs.
- Adding new contacts to a contact list by providing their phone numbers, with automatic creation enabled for numbers not already in the system.
Properties
| Name | Meaning |
|---|---|
| Contact List ID | The unique identifier of the contact list to which contacts will be added. This is a required field to specify the target contact list. |
| Contact IDs | A comma-separated list of contact UUIDs to be added to the contact list. At least one contact ID or phone number must be provided. Maximum 500 entries per request. |
| Phone Numbers | A comma-separated list of phone numbers in E.164 format to be added to the contact list. At least one contact ID or phone number must be provided. Maximum 500 entries per request. |
| Auto Create | A boolean flag indicating whether phone numbers that do not match any existing contact should be automatically created as new contacts when added to the contact list. |
Output
JSON
id- The unique identifier of the contact list after adding contacts.addedContacts- Details of the contacts that were successfully added to the contact list, including any newly created contacts if 'Auto Create' was enabled.
Dependencies
- Requires an API key credential for Yourang API authentication.
Troubleshooting
- Ensure that the Contact List ID is valid and exists in the Yourang system to avoid errors.
- Verify that the Contact IDs and Phone Numbers are correctly formatted and do not exceed the maximum limit of 500 entries per request.
- If 'Auto Create' is enabled, ensure that the phone numbers are in the correct E.164 format to allow successful creation of new contacts.
- Common error messages may include invalid contact list ID, invalid contact IDs or phone numbers, or exceeding the maximum allowed entries. Resolving these involves correcting the input values and retrying the operation.