Skip to content
Skip to main content

Signatures

The Nylas Signatures API lets you create and store HTML email signatures on Nylas, and reference them by ID when sending messages or creating drafts. Nylas appends the signature to the end of the email body at send time.

Nylas signatures are managed entirely through this API and are separate from any signatures configured in the user's email provider (Gmail, Outlook, etc.). Provider signatures are not synced to Nylas, and are not applied to emails sent through the Nylas API.

Each grant supports up to 10 signatures, so users can maintain variants for different contexts (for example, "Work", "Personal", or "Mobile"). Signatures are automatically deleted when the parent grant is deleted.

For more information, see the Using email signatures documentation.

Endpoints

5
GET
Return all signatures
GET /v3/grants/{grant_id}/signatures

Return all signatures for a grant.

POST
Create a signature
POST /v3/grants/{grant_id}/signatures

Create a signature for a grant. Each grant can have up to 10 signatures. Nylas sanitizes the HTML content on input to prevent malicious content. Images must use externally hosted URLs (base64 inline i...

GET
Return a signature
GET /v3/grants/{grant_id}/signatures/{signature_id}

Return a signature by ID.

PUT
Update a signature
PUT /v3/grants/{grant_id}/signatures/{signature_id}

Update the specified signature. You can update the name, body, or both. The signature ID does not change.

DELETE
Delete a signature
DELETE /v3/grants/{grant_id}/signatures/{signature_id}

Permanently delete a signature. Signatures are also automatically deleted when the parent grant is deleted.