add_contact
Add a single contact to a Qualtrics mailing list using directory and mailing list IDs, with fields for email, name, phone, language, and custom data.
Instructions
Add a single contact to a mailing list
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"directoryId": "<directoryId>",
"mailingListId": "<mailingListId>"
},
"name": "add_contact"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| No | Contact email address; identity requirements vary by directory settings | ||
| phone | No | Contact phone number | |
| language | No | Contact language code (e.g., EN) | |
| lastName | No | Contact last name | |
| firstName | No | Contact first name | |
| directoryId | Yes | Required XM Directory ID (POOL_...), also known as the directory or pool ID | |
| embeddedData | No | Custom embedded data fields for the contact | |
| unsubscribed | No | Contact unsubscribe state | |
| mailingListId | Yes | The mailing list ID | |
| externalDataReference | No | External reference (sent as extRef in XM Directory) |