Skip to content
Changelog

Report a bug

Loops.so integration: operations for AI agents

Loops.so connects to Type.com as an integration. This page lists the 71 operations documented for Claude and Codex in Type.com: 33 read, 32 write, 6 destructive.

About Loops.so

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

Categories: Email & Messaging

How to connect Loops.so to Type.com

Access
Organization connection: one shared account for the workspace.

To add the connection, follow the steps in Space connections.

Documented operations

71 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.

71 operations listed.

API key

  • Read

    API key

    Test your API key and get team context.

Audience segments

  • Read

    Get an audience segment

    Retrieve a single audience segment by ID.

  • Read

    List audience segments

    Retrieve a paginated list of audience segments, most recently created first.

  • Write

    Create an audience segment

    Create a new audience segment.

Campaigns

  • Read

    List campaigns

    Retrieve a paginated list of campaigns.

  • Read

    Get a campaign

    Retrieve a single campaign by ID.

  • Read

    Get campaign metrics

    Retrieve all-time email engagement metrics for a campaign.

  • Write

    Create a campaign

    Create a new draft campaign. An empty email message is created automatically and its emailMessageId is returned. Use the /email-messages/{emailMessageId} endpoint to set subject, sender, preview text, and LMX content.

  • Write

    Update a campaign

    Update a draft campaign's name, group, audience (mailing list, segment, or filter), or scheduling. At least one field must be provided. Once a campaign has been sent, only its name and campaignGroupId can be updated.

Campaign groups

  • Read

    List campaign groups

    Retrieve a paginated list of campaign groups, most recently created first.

  • Read

    Get a campaign group

    Retrieve a single campaign group by ID.

  • Write

    Create a campaign group

    Create a new campaign group.

  • Write

    Update a campaign group

    Update a campaign group's name or description. At least one field must be provided. The reserved "Unsorted" group cannot be edited.

Configuration

  • Read

    List dedicated sending IP addresses

    Retrieve a list of Loops' dedicated sending IP addresses. This endpoint is provided for the rare instances where you may need to whitelist our sending IPs. Please note that this list is subject to change and will not include shared IPs used for sending mail.

Contacts

  • Read

    Find a contact

    Search for a contact by email or userId. Only one parameter is allowed.

  • Read

    Get suppression status for a contact

    Retrieve suppression status and removal quota for a contact by email or userId. Include only one query parameter.

  • Write

    Create a contact

    Add a contact to your audience.

  • Destructive

    Update a contact

    Update a contact by email or userId. You must provide one of these parameters. If you want to update a contact's email address, the contact will first need a userId value. You can then make a request containing the userId field along with an updated email address.

  • Destructive

    Delete a contact

    Delete a contact by email or userId.

  • Destructive

    Remove a contact from suppression list

    Remove a suppressed contact from the suppression list by email or userId. Include only one query parameter.

Contact properties

  • Read

    List contact properties

    Retrieve a list of your account's contact properties. Use the list parameter to query "all" or "custom" properties.

  • Write

    Create a contact property

    Create a custom contact property.

Components

  • Read

    Get a component

    Retrieve a single component by ID.

  • Read

    List components

    Retrieve a paginated list of email components.

  • Write

    Update a component

    Update a component's name and/or body. When the lmx body changes, the update cascades to every email using this component, and affectedEmailCount reports how many were affected. A change that would introduce a dynamic variable an email using the component cannot use is rejected.

  • Write

    Create a component

    Create a new email component from an LMX body.

Email messages

  • Read

    Get an email message

    Retrieve an email message, including its compiled LMX content.

  • Read

    Run Guardian checks on an email message

    Validate an email message's content against Guardian rules and return any errors and warnings. Errors must be resolved before the email can be published, warnings are advisory.

  • Write

    Update an email message

    Update fields on an email message (subject, preview text, sender, LMX content). A campaign must be in draft status. You can only edit the draft email message of a transactional email. A workflow must not be sending.

  • Write

    Send a preview of an email message

    Send a test preview of an email message to one or more addresses.

Events

  • Write

    Send an event

    Send events to trigger workflows.

Event patterns

  • Read

    List event patterns

    Retrieve a paginated list of event patterns available to workflow event trigger nodes.

  • Read

    Get an event pattern by name

    Retrieve event pattern details by event name for a workflow event trigger. Event names are case-sensitive, so PaymentReceived and paymentReceived are different events.

  • Read

    Get an event pattern by ID

    Retrieve event pattern details for a workflow event trigger.

Mailing lists

  • Read

    List mailing lists

    Retrieve a list of your account's mailing lists.

Themes

  • Read

    Get a theme

    Retrieve a single theme by ID.

  • Read

    List themes

    Retrieve a paginated list of email themes, most recently created first.

  • Write

    Update a theme

    Update a theme's name and/or styles. When styles change, the update cascades to every email using this theme, and affectedEmailCount in the response reports how many emails were affected.

  • Write

    Create a theme

    Create a new email theme for use across Loops emails.

Transactional emails

  • Read

    List transactional emails

    Retrieve a paginated list of transactional emails, most recently created first.

  • Read

    Get a transactional email

    Retrieve a single transactional email by ID.

  • Read

    Get transactional email metrics

    Retrieve all-time delivery metrics for a transactional email, totalled across every published version.

  • Write

    Send a transactional email

    Send a transactional email to a contact. Please email us to enable attachments on your account before using them with the API.

  • Write

    Create a transactional email

    Create a new transactional email. An empty draft email message is created automatically and its draftEmailMessageId is returned.

  • Write

    Update a transactional email

    Update a transactional email's name or group. At least one field must be provided.

  • Write

    Ensure a draft email message

    Ensure the transactional email has a draft email message. If a draft already exists it is returned unchanged; otherwise a new empty draft is created (seeded from the most recent published version when present).

  • Write

    Publish a transactional email draft

    Publish the transactional email's current draft email message. The draft becomes the published version and the draft is cleared.

Transactional groups

  • Read

    List transactional groups

    Retrieve a paginated list of transactional groups, most recently created first.

  • Read

    Get a transactional group

    Retrieve a single transactional group by ID.

  • Write

    Create a transactional group

    Create a new transactional group.

  • Write

    Update a transactional group

    Update a transactional group's name or description. At least one field must be provided. The reserved "Unsorted" group cannot be edited.

Uploads

  • Write

    Create an upload

    Request a pre-signed URL to upload an image asset. Upload the file with an HTTP PUT to the returned presignedUrl (sending the same Content-Type and Content-Length), then call /uploads/{emailAssetId}/complete to finalize the asset.

  • Write

    Complete an upload

    Finalize an image upload after the file has been uploaded to the pre-signed URL. Returns the public URL of the uploaded image asset.

Workflow groups

  • Read

    List workflow groups

    Retrieve a paginated list of workflow groups, most recently created first.

  • Read

    Get a workflow group

    Retrieve a single workflow group by ID.

  • Write

    Create a workflow group

    Create a new workflow group.

  • Write

    Update a workflow group

    Update a workflow group's name or description. At least one field must be provided. The reserved "Unsorted" group cannot be edited.

Workflows

  • Read

    List workflows

    Retrieve a paginated list of workflows.

  • Read

    Get a workflow

    Retrieve a workflow graph with node type names, connections, and selected display fields.

  • Write

    Create a workflow

    Create a draft workflow with a blank trigger and exit node. When workflowGroupId is omitted, the workflow is added to the team's Unsorted group.

  • Write

    Update a workflow

    Update a workflow's name, description, or group. At least one field must be provided. To change the workflow's mailing list, use the POST /v1/workflows/{workflowId}/mailing-list endpoint instead.

  • Write

    Change workflow mailing list

    Dry run or apply a workflow mailing list change. If queued contacts would be removed from the workflow due to the change of mailing list, Loops returns with "status": "queuedContactsFound" instead of applying the change.

  • Destructive

    Delete a workflow

    Delete a workflow. Successful deletion returns 204 No Content. If the workflow is currently sending or has queued contacts, Loops returns 409 Conflict with a message instead of deleting.

Workflow nodes

  • Read

    Get a workflow node

    Retrieve detailed data for a single workflow node.

  • Read

    Get workflow node metrics

    Retrieve all-time email engagement metrics for a workflow SendEmailAction node. Nodes of any other type return a 400 response. A SendEmailAction node with an email that has not sent anything yet reports every counter as 0.

  • Write

    Create a workflow node

    Create a new default workflow node and return it with the latest workflow.

  • Write

    Add a branch

    Add a branch and a child node under an existing Branch or Experiment node. Returns the created child node plus the latest workflow. - Adding a branch to a BranchNode creates one AudienceFilter child node.

  • Write

    Update a workflow node

    Update workflow-node-owned fields for a single node. To update a node, the workflow's state must not be Sending. Shared resources such as email messages and audience segments should be updated through their own APIs.

  • Write

    Reroute a node connection

    Reroute the source node's existing connection to another valid target node. Returns the updated source node and the latest workflow.

  • Destructive

    Delete a workflow node

    Delete a single workflow node. If contacts are queued at the node, Loops returns with "status": "queuedContactsFound" instead of deleting. Retry with queuedContactPolicy: "discard" to delete the node and discard those queued contacts.

  • Destructive

    Delete workflow nodes recursively

    Delete a node and its downstream subtree. If contacts are queued at any node that would be deleted, Loops returns with "status": "queuedContactsFound" instead of deleting. Retry with queuedContactPolicy: "discard" to delete the nodes and discard those queued contacts.

See How connections work for access and permissions, or browse all integrations.