Send a message

POST {{baseUrl}}/v3/grants/:grant_id/messages/send

You can use the Send v3 API to send a message now, or schedule it to send later. To send a message now, omit the send_at field. To schedule a message, set the send_at field to the epoch time when you want to send the message. See the Messages documentation for more information.

Request Body

{"subject"=>"Hey Reaching Out with Nylas", "body"=>"Hey I would like to track this link <a href='https://espn.com'>My Example Link</a>", "to"=>[{"name"=>"John Doe", "email"=>"john.doe@example.com"}], "tracking_options"=>{"opens"=>true, "links"=>true, "thread_replies"=>true, "label"=>"hey just testing"}}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;grant_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;data&quot;:{&quot;bcc&quot;:[{&quot;email&quot;:&quot;\u003cemail\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;},{&quot;email&quot;:&quot;\u003cemail\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;}],&quot;body&quot;:&quot;\u003cstring\u003e&quot;,&quot;cc&quot;:[{&quot;email&quot;:&quot;\u003cemail\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;},{&quot;email&quot;:&quot;\u003cemail\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;}],&quot;date&quot;:&quot;\u003cinteger\u003e&quot;,&quot;attachments&quot;:[{&quot;content_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;filename&quot;:&quot;\u003cstring\u003e&quot;,&quot;grant_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_inline&quot;:&quot;\u003cboolean\u003e&quot;,&quot;size&quot;:&quot;\u003cinteger\u003e&quot;},{&quot;content_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;filename&quot;:&quot;\u003cstring\u003e&quot;,&quot;grant_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_inline&quot;:&quot;\u003cboolean\u003e&quot;,&quot;size&quot;:&quot;\u003cinteger\u003e&quot;}],&quot;folders&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;from&quot;:[{&quot;email&quot;:&quot;\u003cemail\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;},{&quot;email&quot;:&quot;\u003cemail\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;}],&quot;grant_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;object&quot;:&quot;\u003cstring\u003e&quot;,&quot;reply_to&quot;:[{&quot;email&quot;:&quot;\u003cemail\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;},{&quot;email&quot;:&quot;\u003cemail\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;}],&quot;schedule_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;snippet&quot;:&quot;\u003cstring\u003e&quot;,&quot;starred&quot;:&quot;\u003cboolean\u003e&quot;,&quot;subject&quot;:&quot;\u003cstring\u003e&quot;,&quot;thread_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;to&quot;:[{&quot;email&quot;:&quot;\u003cemail\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;},{&quot;email&quot;:&quot;\u003cemail\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;}],&quot;unread&quot;:&quot;\u003cboolean\u003e&quot;,&quot;use_draft&quot;:&quot;\u003cboolean\u003e&quot;},&quot;request_id&quot;:&quot;\u003cstring\u003e&quot;}