mail_contact_create

Tool

Add a contact to an audience

Name	Type	Required	Description
email	string	•	Contact email address
properties	object	—	Custom key/value properties (e.g. first_name, last_name)
audience_id	string	•	Audience the contact belongs to
unsubscribed	boolean	—	Marketing opt-out flag

Field	Type	Always	Description
id	string	•	Contact id
email	string	•	Contact email address, normalized to lowercase
createdAt	string	•	When the contact was created (ISO 8601 UTC)
updatedAt	string	•	When the contact was last modified (ISO 8601 UTC)
audienceId	string	•	Audience the contact belongs to
properties	string	—	Custom key/value properties (e.g. first_name, last_name)
unsubscribed	boolean	•	Marketing opt-out flag for this audience

Add a contact to an audience.

When to use

Add a contact to an audience

Ask your agent something like this:

Add a contact to an audience.

The agent will invoke mail_contact_create with these arguments:

{
  "email": "<email>",
  "audience_id": "<audience_id>"
}