SendGrid

Twilio SendGrid Marketing Campaigns Single Sends API

The Twilio SendGrid Single Sends API allows you to create, manage, and send Single Sends. You can also search Single Sends and retrieve statistics about them…

Communication#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

The Twilio SendGrid Single Sends API allows you to create, manage, and send Single Sends. You can also search Single Sends and retrieve statistics about them to help you maintain, alter, and further develop your campaigns.

A Single Send is a one-time non-automated email message delivered to a list or segment of your audience. A Single Send may be sent immediately or scheduled for future delivery.

Single Sends can serve many use cases, including promotional offers, engagement campaigns, newsletters, announcements, legal notices, or policy updates. You can also create and manage Single Sends in the Marketing Campaigns application user interface.

The Single Sends API changed on May 6, 2020. See Single Sends 2020 Update for more information.

Endpoints 11

Single Sends

  • GETGet All Single Sends/v3/marketing/singlesends?page_size=0&page_token=stringThis endpoint allows you to retrieve all your Single Sends. Returns all of your Single Sends with condensed details about each, including the Single Sends'…
  • POSTCreate Single Send/v3/marketing/singlesendsThis endpoint allows you to create a new Single Send. Please note that if you are migrating from the previous version of Single Sends, you no longer need to…
  • DELETEBulk Delete Single Sends/v3/marketing/singlesends?ids=stringThis endpoint allows you to delete multiple Single Sends using an array of Single Sends IDs. To first retrieve all your Single Sends' IDs, you can make a GET…
  • GETGet Single Send by ID/v3/marketing/singlesends/:idThis endpoint allows you to retrieve details about one Single Send using a Single Send ID. You can retrieve all of your Single Sends by making a GET request…
  • POSTDuplicate Single Send/v3/marketing/singlesends/:idThis endpoint allows you to duplicate an existing Single Send using its Single Send ID. Duplicating a Single Send is useful when you want to create a Single…
  • DELETEDelete Single Send by ID/v3/marketing/singlesends/:idThis endpoint allows you to delete one Single Send using a Single Send ID. To first retrieve all your Single Sends' IDs, you can make a GET request to the…
  • PATCHUpdate Single Send/v3/marketing/singlesends/:idThis endpoint allows you to update a Single Send using a Single Send ID. You only need to pass the properties you want to update. Any blank or missing…
  • PUTSchedule Single Send/v3/marketing/singlesends/:id/scheduleThis endpoint allows you to send a Single Send immediately or schedule it to be sent at a later time. To send your message immediately, set the send_at…
  • DELETEDelete Single Send Schedule/v3/marketing/singlesends/:id/scheduleThis endpoint allows you to cancel a scheduled Single Send using a Single Send ID. Making a DELETE request to this endpoint will cancel the scheduled sending…
  • GETGet All Categories/v3/marketing/singlesends/categoriesThis endpoint allows you to retrieve all the categories associated with your Single Sends. This endpoint will return your latest 1,000 categories.
  • POSTGet Single Sends Search/v3/marketing/singlesends/search?page_size=0&page_token=stringThis endpoint allows you to search for Single Sends based on specified criteria. You can search for Single Sends by passing a combination of values using the…

API details

Base URL
https://api.sendgrid.com
Authentication
A bearer token in the Authorization header
Operations
11 operations on 5 pathsGET 3POST 3DELETE 3PUT 1PATCH 1
Main resources
Single Sends 11
Response formats
application/json
Description format
OpenAPI 3.1.0, API version 1.0.0

How to test the Twilio SendGrid Marketing Campaigns Single Sends API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Twilio SendGrid Marketing Campaigns Single Sends API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Get All Single Sends” (GET /v3/marketing/singlesends?page_size=0&page_token=string), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Twilio SendGrid Marketing Campaigns Single Sends API?

The Twilio SendGrid Single Sends API allows you to create, manage, and send Single Sends. You can also search Single Sends and retrieve statistics about them… It is listed under Communication and has 11 endpoints.

Who publishes the Twilio SendGrid Marketing Campaigns Single Sends API?

It is listed from SendGrid's public API description (an OpenAPI document), not published by SendGrid on Swastik Codes. Anyone who controls sendgrid.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Twilio SendGrid Marketing Campaigns Single Sends API?

Requests go to https://api.sendgrid.com. Endpoint paths are added to this base URL.

How do I authenticate with the Twilio SendGrid Marketing Campaigns Single Sends API?

With A bearer token in the Authorization header.

How many endpoints does the Twilio SendGrid Marketing Campaigns Single Sends API have?

11 operations on 5 paths (3 GET, 3 POST, 3 DELETE, 1 PUT, 1 PATCH). The largest groups are Single Sends.

Is forking the Twilio SendGrid Marketing Campaigns Single Sends API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.