Open Connector
← All tools

SendGrid Marketing Lists

Manage Twilio SendGrid Marketing Campaigns contact lists.

sendgrid-marketing-listsv1.0.07 tools

Authentication

MethodKindStatusDetails
API Keyapi_keyavailable—

Call a tool

import { createClient } from "@open-connector/sdk";const oc = createClient({  baseUrl: "https://api.openconnector.dev",  apiKey: process.env.OPEN_CONNECTOR_API_KEY!,});const result = await oc.executeTool({  slug: "SENDGRID_MARKETING_LISTS_CREATE_MARKETING_LIST",  connectedAccountId: "conn_...",  arguments: { /* match this tool's input schema */ },});
import Composio from "@composio/client";const composio = new Composio({  baseURL: "https://api.openconnector.dev/composio",  apiKey: process.env.OPEN_CONNECTOR_API_KEY!,});const result = await composio.tools.execute("SENDGRID_MARKETING_LISTS_CREATE_MARKETING_LIST", {  connected_account_id: "conn_...",  arguments: { /* match this tool's input schema */ },});
oc tools execute SENDGRID_MARKETING_LISTS_CREATE_MARKETING_LIST --data '{ }'

Tool catalog

Available tools

7 callable operations

Create ListSENDGRID_MARKETING_LISTS_CREATE_MARKETING_LIST**This endpoint creates a new contacts list.** Once you create a list, you can use the UI to [trigger an automation](https://sendgrid.com/docs/ui/sending-email/getting-started-with-automation/#create-an-automation) every time you add a new contact to the list. A link to the newly created object is in `_metadata`.

**This endpoint creates a new contacts list.** Once you create a list, you can use the UI to [trigger an automation](https://sendgrid.com/docs/ui/sending-email/getting-started-with-automation/#create-an-automation) every time you add a new contact to the list. A link to the newly created object is in `_metadata`.

Authentication

Connected account required

Tags

Lists
Remove Contacts from a ListSENDGRID_MARKETING_LISTS_DELETE_CONTACT**This endpoint allows you to remove contacts from a given list.** The contacts will not be deleted. Only their list membership will be changed.

**This endpoint allows you to remove contacts from a given list.** The contacts will not be deleted. Only their list membership will be changed.

Authentication

Connected account required

Tags

Lists
Delete a listSENDGRID_MARKETING_LISTS_DELETE_MARKETING_LIST**This endpoint allows you to deletes a specific list.** Optionally, you can also delete contacts associated to the list. The query parameter, `delete_contacts=true`, will delete the list and start an asynchronous job to delete associated contacts.

**This endpoint allows you to deletes a specific list.** Optionally, you can also delete contacts associated to the list. The query parameter, `delete_contacts=true`, will delete the list and start an asynchronous job to delete associated contacts.

Authentication

Connected account required

Tags

Lists
Get a List by IDSENDGRID_MARKETING_LISTS_GET_MARKETING_LIST**This endpoint returns data about a specific list.** Setting the optional parameter `contact_sample=true` returns the `contact_sample` in the response body. Up to 50 of the most recent contacts uploaded or attached to a list will be returned. The full contact count is also returned.

**This endpoint returns data about a specific list.** Setting the optional parameter `contact_sample=true` returns the `contact_sample` in the response body. Up to 50 of the most recent contacts uploaded or attached to a list will be returned. The full contact count is also returned.

Authentication

Connected account required

Tags

Lists
Get List Contact CountSENDGRID_MARKETING_LISTS_LIST_CONTACT_COUNT**This endpoint returns the number of contacts on a specific list.**

**This endpoint returns the number of contacts on a specific list.**

Authentication

Connected account required

Tags

Lists
Get All ListsSENDGRID_MARKETING_LISTS_LIST_MARKETING_LIST**This endpoint returns an array of all of your contact lists.**

**This endpoint returns an array of all of your contact lists.**

Authentication

Connected account required

Tags

Lists
Update ListSENDGRID_MARKETING_LISTS_UPDATE_MARKETING_LIST**This endpoint updates the name of a list.**

**This endpoint updates the name of a list.**

Authentication

Connected account required

Tags

Lists

Provider resources