> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Loops.so

> The email platform for modern SaaS. A better way to send product, marketing, and transactional email.

![Loops.so logo](https://mintcdn.com/composio-preview/ufpARLIsio16odJB/images/toolkits/loops_so.svg?fit=max\&auto=format\&n=ufpARLIsio16odJB\&q=85\&s=52f70156f9af34ffe1d0c359bbcfc273)

* **Category:** email
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 12
* **Triggers:** 0
* **Slug:** `LOOPS_SO`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Contact
>
> **Slug:** `LOOPS_SO_CREATE_CONTACT`
>
> Create a contact in your Loops audience using an email address and optional supported properties such as name, subscription status and mailing lists. Subscription defaults to true.
>
> #### Input Parameters
>
> **email** `string` *required*
>
> The contact's email address. This is the unique identifier for the contact.
>
> **source** `string`
>
> Custom source value to replace the default 'API' source attribution.
>
> **userId** `string`
>
> Unique user ID from your external application for linking contacts.
>
> **lastName** `string`
>
> The contact's last name.
>
> **firstName** `string`
>
> The contact's first name.
>
> **userGroup** `string`
>
> Segment users into groups. A contact can only be in one user group at a time.
>
> **subscribed** `boolean`
>
> Whether the contact should receive campaign and loops emails. Defaults to true if not specified.
>
> **mailingLists** `object`
>
> Key-value pairs mapping mailing list IDs to boolean subscription status. Keys are mailing list IDs, values indicate subscription status.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Contact Property
>
> **Slug:** `LOOPS_SO_CREATE_CONTACT_PROPERTY`
>
> Tool to add a custom contact property to your Loops team. Use when you need to store additional contact data beyond default fields. Properties must have unique names in camelCase format and a specified data type (string, number, boolean, or date).
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the property in camelCase format (e.g., planName, favoriteColor). This will be used to identify the property in your contact data.
>
> **type** `string ("string" | "number" | "boolean" | "date")` *required*
>
> The property's data type. Must be one of: string, number, boolean, or date.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Contact
>
> **Slug:** `LOOPS_SO_DELETE_CONTACT`
>
> Tool to delete a contact by email address or user ID. Use when you need to remove a contact from Loops. Either email or userId must be provided to identify the contact.
>
> #### Input Parameters
>
> **email** `string`
>
> The contact's email address to identify which contact to delete
>
> **userId** `string`
>
> The contact's userId value to identify which contact to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find Contact
>
> **Slug:** `LOOPS_SO_FIND_CONTACT`
>
> Search for a contact by email or userId and retrieve contact details including subscription status. Exactly one of email or userId must be provided per request.
>
> #### Input Parameters
>
> **email** `string`
>
> The contact's email address to search for. Must be URI-encoded. Only one of email or userId is allowed per request.
>
> **userId** `string`
>
> The contact's unique user ID to search for. Only one of email or userId is allowed per request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Contact Properties
>
> **Slug:** `LOOPS_SO_GET_CONTACT_PROPERTIES`
>
> Tool to retrieve a list of your account's contact properties from Loops.so. Use when you need to view all available contact properties or filter to only custom properties created by your team.
>
> #### Input Parameters
>
> **list** `string`
>
> Use 'custom' to filter results to only custom properties created by your team. Omit this parameter to retrieve all properties (both standard and custom).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Dedicated Sending IPs
>
> **Slug:** `LOOPS_SO_GET_DEDICATED_SENDING_IPS`
>
> Tool to retrieve a list of Loops' dedicated sending IP addresses. Use when you need to get IP addresses for whitelisting purposes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Mailing Lists
>
> **Slug:** `LOOPS_SO_GET_MAILING_LISTS`
>
> Tool to retrieve all mailing lists associated with your Loops account. Use when you need to browse or manage mailing list information.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Custom Fields
>
> **Slug:** `LOOPS_SO_LIST_CUSTOM_FIELDS`
>
> Tool to retrieve a list of custom contact properties. Use when you need to view available custom fields for contacts. Note: This endpoint is deprecated in favor of 'List contact properties'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Transactional Emails
>
> **Slug:** `LOOPS_SO_LIST_TRANSACTIONAL_EMAILS`
>
> Tool to retrieve a list of published transactional emails. Use when you need to view all available transactional email templates. Supports pagination with perPage and cursor parameters.
>
> #### Input Parameters
>
> **cursor** `string`
>
> A cursor to return a specific page of results. Cursors can be found from the pagination.nextCursor value in each response.
>
> **perPage** `integer`
>
> How many results to return in each request. Must be between 10 and 50. Default: 20
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send Event
>
> **Slug:** `LOOPS_SO_SEND_EVENT`
>
> Send an event for a contact to track actions and trigger automated Loops workflows. The request can also update mailing list subscriptions.
>
> #### Input Parameters
>
> **email** `string`
>
> The contact's email address. Required if userId is not provided.
>
> **userId** `string`
>
> The contact's unique user ID. Required if email is not provided.
>
> **eventName** `string` *required*
>
> The name of the event to trigger.
>
> **mailingLists** `object`
>
> Mailing list subscriptions as key-value pairs. Keys are list IDs, values are boolean (true to add, false to remove).
>
> **idempotencyKey** `string`
>
> Optional idempotency key (up to 100 characters) to avoid duplicate requests within 24 hours.
>
> **eventProperties** `object`
>
> Event property data as key-value pairs. Values can be string, number, boolean, or date.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Test API Key
>
> **Slug:** `LOOPS_SO_TEST_API_KEY`
>
> Tool to test API key validity and retrieve team information. Use to verify API credentials are working correctly.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Contact
>
> **Slug:** `LOOPS_SO_UPDATE_CONTACT`
>
> Tool to update an existing contact by email or userId. Use when you need to modify contact properties or re-subscribe contacts. Creates a new contact if no matching record exists.
>
> #### Input Parameters
>
> **email** `string`
>
> Contact's email address. Creates new contact if none exists. Required if userId is not provided.
>
> **source** `string`
>
> Custom source value replacing default 'API'
>
> **userId** `string`
>
> Unique user identifier from external applications. Required if email is not provided.
>
> **lastName** `string`
>
> Contact's last name
>
> **firstName** `string`
>
> Contact's first name
>
> **userGroup** `string`
>
> Single group for user segmentation
>
> **subscribed** `boolean`
>
> Determines campaign/loop email eligibility. Setting to true will re-subscribe previously unsubscribed contacts.
>
> **mailingLists** `object`
>
> Key-value pairs of list IDs with boolean subscription status
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
