Skip to main content
POST
/
sends
cURL
curl --request POST \
  --url https://api.notocat.com/v1/sends \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "workspace_id": "<string>",
  "page_id": "<string>",
  "subject": "<string>",
  "preheader": "<string>",
  "segment_id": "<string>",
  "font": "<string>",
  "css": "<string>",
  "linkColor": "#0000ED",
  "dividerColor": "#434343",
  "dividerSize": 1,
  "showCover": true,
  "trackOpens": true,
  "trackLinks": true
}'
{
  "id": "<string>",
  "workspace_id": "<string>",
  "segment_id": "<string>",
  "page_id": "<string>",
  "html": "<string>",
  "subject": "<string>",
  "preheader": "<string>",
  "font": "<string>",
  "css": "<string>",
  "linkColor": "#0000ED",
  "status": "draft",
  "dividerColor": "#434343",
  "dividerSize": 1,
  "showCover": true,
  "sentAt": "2023-11-07T05:31:56Z",
  "trackOpens": true,
  "trackLinks": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}
This endpoint can be used to create a send from a Notion page. The send will be created with the page’s properties and the page’s content will be transformed into an issue to be sent.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Transform a Notion page into an issue to be sent

​
workspace_id
string
required

The ID of the workspace

​
page_id
string
required

The ID of the Notion page to transform into an issue

​
subject
string

The subject line of the email. If not provided, it will be extracted from the Notion page properties.

​
preheader
string

The preheader text of the email

​
segment_id
string

The ID of the segment to send to. If not provided, all workspace contacts will be used.

​
font
string

The font used in the email

​
css
string

Custom CSS for the email

​
linkColor
string
default:#0000ED

The color of links in the email

​
dividerColor
string
default:#434343

The color of dividers in the email

​
dividerSize
integer
default:1

The size of dividers in the email

​
showCover
boolean
default:true

Whether to show the cover image in the email

​
trackOpens
boolean
default:true

Whether to track email opens

​
trackLinks
boolean
default:true

Whether to track link clicks

Response

Send created

​
id
string

The unique ID of the send

​
workspace_id
string

The ID of the workspace this send belongs to

​
segment_id
string

The ID of the segment this send is targeting (optional)

​
page_id
string

The ID of the Notion page this send is based on

​
html
string

The HTML content of the email

​
subject
string

The subject line of the email

​
preheader
string

The preheader text of the email

​
font
string

The font used in the email

​
css
string

Custom CSS for the email

​
linkColor
string
default:#0000ED

The color of links in the email

​
status
enum<string>
default:draft

The status of the send

Available options:
draft,
sending,
sent
​
dividerColor
string
default:#434343

The color of dividers in the email

​
dividerSize
integer
default:1

The size of dividers in the email

​
showCover
boolean
default:true

Whether to show the cover image in the email

​
sentAt
string<date-time>

The timestamp when the send was sent

​
trackOpens
boolean
default:true

Whether to track email opens

​
trackLinks
boolean
default:true

Whether to track link clicks

​
createdAt
string<date-time>

Creation timestamp

​
updatedAt
string<date-time>

Last update timestamp