← Tools Reference

Loops

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

API key8 toolshttps://app.loops.so
POST
loops_create_contact
Create a Loops contact with default and custom contact properties.

/contacts/create

9 parameters
ParamTypeRequiredDescription
emailstringrequiredThe contact's email address.
firstNamestringoptionalThe contact's first name.
lastNamestringoptionalThe contact's last name.
sourcestringoptionalA custom source value that replaces the default "API" source.
subscribedbooleanoptionalWhether the contact receives campaign and workflow emails.
userGroupstringoptionalThe user group used to segment the contact.
userIdstringoptionalThe unique user ID from an external application.
mailingListsobjectoptionalMailing list subscription changes keyed by Loops mailing list ID.
customPropertiesobjectoptionalCustom contact or event properties keyed by their Loops property name.
PUT
loops_update_contact
Update or create a Loops contact by email or userId.

/contacts/update

9 parameters
ParamTypeRequiredDescription
emailstringoptionalThe contact's email address.
userIdstringoptionalThe unique user ID from an external application.
firstNamestringoptionalThe contact's first name.
lastNamestringoptionalThe contact's last name.
sourcestringoptionalA custom source value that replaces the default "API" source.
subscribedbooleanoptionalWhether the contact receives campaign and workflow emails.
userGroupstringoptionalThe user group used to segment the contact.
mailingListsobjectoptionalMailing list subscription changes keyed by Loops mailing list ID.
customPropertiesobjectoptionalCustom contact or event properties keyed by their Loops property name.
GET
loops_find_contact
Find Loops contacts by email or userId.

/api/v1/contacts/find

2 parameters
ParamTypeRequiredDescription
emailstringoptionalThe contact's email address.
userIdstringoptionalThe unique user ID from an external application.
POST
loops_delete_contact
Delete a Loops contact by email or userId.

/contacts/delete

2 parameters
ParamTypeRequiredDescription
emailstringoptionalThe contact's email address.
userIdstringoptionalThe unique user ID from an external application.
POST
loops_create_contact_property
Create a custom contact property in Loops.

/contacts/properties

2 parameters
ParamTypeRequiredDescription
namestringoptionalThe camelCase contact property name.
typestringoptionalThe Loops contact property type.
GET
loops_list_contact_properties
List default or custom Loops contact properties.

/contacts/properties

1 parameter
ParamTypeRequiredDescription
liststringoptionalWhich contact properties to list.
GET
loops_list_mailing_lists
List Loops mailing lists available to the current API key.

/lists

POST
loops_send_event
Send a Loops event to trigger workflows for a contact.

/events/send

6 parameters
ParamTypeRequiredDescription
eventNamestringrequiredThe Loops event name to trigger.
emailstringoptionalThe contact's email address.
userIdstringoptionalThe unique user ID from an external application.
idempotencyKeystringoptionalAn optional idempotency key sent as the Idempotency-Key header.
eventPropertiesobjectoptionalCustom contact or event properties keyed by their Loops property name.
contactPropertiesobjectoptionalCustom contact or event properties keyed by their Loops property name.