← Tools Reference

Userlist

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

API key5 toolshttps://push.userlist.com
POST
userlist_push_user
Create or update a Userlist user through the Push API.

/users

8 parameters
ParamTypeRequiredDescription
identifierstringoptionalA Userlist resource identifier.
emailstringoptionalThe email address of the user.
signed_up_atstringoptionalWhen the user signed up.
propertiesobjectoptionalCustom properties stored by Userlist. Keys are normalized to snake_case by User…
relationshipsarrayoptionalRelationships to companies for this user.
companystringoptionalA Userlist company identifier or embedded company object.
companiesarrayoptionalCompany identifiers or embedded companies.
preferencesarrayoptionalSubscription preference updates for this user.
POST
userlist_push_company
Create or update a Userlist company through the Push API.

/companies

7 parameters
ParamTypeRequiredDescription
identifierstringrequiredA Userlist resource identifier.
namestringoptionalThe company name.
signed_up_atstringoptionalWhen the company signed up.
propertiesobjectoptionalCustom properties stored by Userlist. Keys are normalized to snake_case by User…
relationshipsarrayoptionalRelationships to users for this company.
userstringoptionalA Userlist user identifier or embedded user object.
usersarrayoptionalUser identifiers or embedded users.
POST
userlist_push_relationship
Create or update a Userlist relationship between a user and a company.

/relationships

3 parameters
ParamTypeRequiredDescription
userstringrequiredA Userlist user identifier or embedded user object.
companystringrequiredA Userlist company identifier or embedded company object.
propertiesobjectoptionalCustom properties stored by Userlist. Keys are normalized to snake_case by User…
POST
userlist_create_event
Create a Userlist event for a user, company, or both.

/events

5 parameters
ParamTypeRequiredDescription
namestringrequiredThe event name.
userstringoptionalA Userlist user identifier or embedded user object.
companystringoptionalA Userlist company identifier or embedded company object.
occurred_atstringoptionalWhen the event occurred.
propertiesobjectoptionalCustom properties stored by Userlist. Keys are normalized to snake_case by User…
POST
userlist_send_message
Send a Userlist transactional message to a user or email address.

/messages

14 parameters
ParamTypeRequiredDescription
templatestringoptionalThe transactional message template identifier.
userstringoptionalA Userlist user identifier or embedded user object.
companystringoptionalA Userlist company identifier or embedded company object.
propertiesobjectoptionalCustom properties stored by Userlist. Keys are normalized to snake_case by User…
channelstringoptionalThe delivery channel for the message.
tostringoptionalThe recipient email address for email messages.
fromstringoptionalThe sender email address for email messages.
reply_tostringoptionalThe reply-to email address for email messages.
subjectstringoptionalThe custom message subject. Required when template is omitted.
preheaderstringoptionalThe custom email preheader text.
bodyobjectoptionalThe Userlist transactional message body.
senderstringoptionalThe sender identifier configured in Userlist.
themestringoptionalThe theme identifier to apply, or false to disable theming.
topicstringoptionalThe topic identifier configured in Userlist.