← Tools Reference

Omnisend

Omnisend integration (Marketing, Communication). Imported from open-connector.

API key9 toolshttps://api.omnisend.com/api
GET
omnisend_list_contacts
List Omnisend contacts with documented filters and cursor pagination.

/contacts

11 parameters
ParamTypeRequiredDescription
limitintegeroptionalNumber of contacts per page. Range: 1-250.
afterstringoptionalOpaque cursor for fetching the next page.
beforestringoptionalOpaque cursor for fetching the previous page.
sortstringoptionalContact sort field accepted by Omnisend.
directionstringoptionalSort direction accepted by Omnisend.
emailstringoptionalFilter by email address.
phonestringoptionalFilter by phone number.
statusstringoptionalContact subscription status filter.
segmentIDstringoptionalFilter by segment ID.
tagstringoptionalFilter by tag. Cannot be combined with status.
updatedAtFromstringoptionalFilter contacts updated at or after this RFC3339 timestamp.
GET
omnisend_get_contact
Fetch a single Omnisend contact by ID.

/contacts/{contactID}

1 parameter
ParamTypeRequiredDescription
contactIDstringrequiredOmnisend contact ID.
POST
omnisend_upsert_contact
Create a new Omnisend contact or update an existing contact matched by email.

/contacts

14 parameters
ParamTypeRequiredDescription
addressstringoptionalStreet, house number, apartment number.
birthdatestringoptionalContact birthdate in YYYY-MM-DD format.
citystringoptionalContact city.
countrystringoptionalCountry name. Used to derive ISO country code when countryCode is not provided.
countryCodestringoptionalISO 3166-1 alpha-2 country code.
createdAtstringoptionalContact creation timestamp. Omnisend stores it as the "externalCreated" custom …
customPropertiesobjectoptionalCustom contact properties defined for the brand.
firstNamestringoptionalContact first name.
genderstringoptionalContact gender accepted by Omnisend.
identifiersarrayrequiredContact identifiers, such as email or phone.
lastNamestringoptionalContact last name.
postalCodestringoptionalPostal or zip code.
statestringoptionalState or region.
tagsarrayoptionalLabels assigned to the contact.
PATCH
omnisend_update_contact_by_id
Update an existing Omnisend contact selected by contact ID.

/contacts/{contactID}

15 parameters
ParamTypeRequiredDescription
contactIDstringrequiredOmnisend contact ID.
addressstringoptionalStreet, house number, apartment number.
birthdatestringoptionalContact birthdate in YYYY-MM-DD format.
citystringoptionalContact city.
countrystringoptionalCountry name. Used to derive ISO country code when countryCode is not provided.
countryCodestringoptionalISO 3166-1 alpha-2 country code.
createdAtstringoptionalContact creation timestamp. Omnisend stores it as the "externalCreated" custom …
customPropertiesobjectoptionalCustom contact properties defined for the brand.
firstNamestringoptionalContact first name.
genderstringoptionalContact gender accepted by Omnisend.
identifiersarrayoptionalContact identifiers, such as email or phone.
lastNamestringoptionalContact last name.
postalCodestringoptionalPostal or zip code.
statestringoptionalState or region.
tagsarrayoptionalLabels assigned to the contact.
PATCH
omnisend_update_contact_by_email
Update an existing Omnisend contact selected by email address.

/contacts

15 parameters
ParamTypeRequiredDescription
emailstringrequiredContact email address used to select the Omnisend contact.
addressstringoptionalStreet, house number, apartment number.
birthdatestringoptionalContact birthdate in YYYY-MM-DD format.
citystringoptionalContact city.
countrystringoptionalCountry name. Used to derive ISO country code when countryCode is not provided.
countryCodestringoptionalISO 3166-1 alpha-2 country code.
createdAtstringoptionalContact creation timestamp. Omnisend stores it as the "externalCreated" custom …
customPropertiesobjectoptionalCustom contact properties defined for the brand.
firstNamestringoptionalContact first name.
genderstringoptionalContact gender accepted by Omnisend.
identifiersarrayoptionalContact identifiers, such as email or phone.
lastNamestringoptionalContact last name.
postalCodestringoptionalPostal or zip code.
statestringoptionalState or region.
tagsarrayoptionalLabels assigned to the contact.
POST
omnisend_add_tags
Add tags to multiple Omnisend contacts in a batch.

/contacts/tags

2 parameters
ParamTypeRequiredDescription
contactIDsarrayrequiredOmnisend contact IDs.
tagsarrayrequiredTags to add or remove.
DELETE
omnisend_remove_tags
Remove tags from multiple Omnisend contacts in a batch.

/contacts/tags

2 parameters
ParamTypeRequiredDescription
contactIDsarrayrequiredOmnisend contact IDs.
tagsarrayrequiredTags to add or remove.
GET
omnisend_list_segments
List Omnisend segments with sorting and cursor pagination.

/segments

5 parameters
ParamTypeRequiredDescription
limitintegeroptionalNumber of segments per page. Range: 1-50.
afterstringoptionalOpaque cursor for fetching the next page.
beforestringoptionalOpaque cursor for fetching the previous page.
sortstringoptionalSegment sort field accepted by Omnisend.
directionstringoptionalSort direction accepted by Omnisend.
GET
omnisend_get_segment
Fetch a single Omnisend segment by ID.

/segments/{segmentID}

1 parameter
ParamTypeRequiredDescription
segmentIDstringrequiredOmnisend segment ID. Omnisend documents segment IDs as 24-character hexadecimal…