SendGrid

Add or update one or more contacts; async, returns job_id (PUT /marketing/contacts).

Search contacts via SGQL query (POST /marketing/contacts/search).

Get contacts by email address(es) (POST /marketing/contacts/search/emails).

Get a sample of contacts (GET /marketing/contacts).

Get total contact count + billable count (GET /marketing/contacts/count).

Get a contact by ID (GET /marketing/contacts/{id}).

Delete contacts by ids or delete_all_contacts (DELETE /marketing/contacts).

Request a contact import upload URL (POST /marketing/contacts/imports).

Get import job status (GET /marketing/contacts/imports/{id}).

Request a contact export (POST /marketing/contacts/exports).

List all export jobs (GET /marketing/contacts/exports).

Get an export job status (GET /marketing/contacts/exports/{id}).

Get batched contacts by IDs (POST /marketing/contacts/batch).

Create a marketing list (POST /marketing/lists).

Get all marketing lists, paginated (GET /marketing/lists).

Get a list by ID (GET /marketing/lists/{id}).

Get list contact count (GET /marketing/lists/{id}/contacts/count).

Update a list (PATCH /marketing/lists/{id}).

Delete a list (DELETE /marketing/lists/{id}).

Remove contacts from a list (DELETE /marketing/lists/{id}/contacts).

Create a segment (Segments v2) (POST /marketing/segments/2.0).

Get list of segments (GET /marketing/segments/2.0).

Get a segment by ID (GET /marketing/segments/2.0/{id}).

Update a segment (PATCH /marketing/segments/2.0/{id}).

Delete a segment (DELETE /marketing/segments/2.0/{id}).

Refresh a segment's sample (POST /marketing/segments/2.0/refresh/{id}).

Create a custom field definition (POST /marketing/field_definitions).

Get all field definitions (custom + reserved) (GET /marketing/field_definitions).

Update a custom field definition (PATCH /marketing/field_definitions/{custom_field_id}).

Delete a custom field definition (DELETE /marketing/field_definitions/{custom_field_id}).

Create a sender identity (POST /marketing/senders).

Get all senders (GET /marketing/senders).

Get a specific sender (GET /marketing/senders/{id}).

Update a sender (PATCH /marketing/senders/{id}).

Delete a sender (DELETE /marketing/senders/{id}).

Resend sender verification (POST /marketing/senders/{id}/resend_verification).

Cancel or pause a scheduled send by batch_id (POST /user/scheduled_sends).

Retrieve all cancel/pause scheduled send statuses (GET /user/scheduled_sends).

Retrieve a specific scheduled send status (GET /user/scheduled_sends/{batch_id}).

Update a scheduled send cancel/pause status (PATCH /user/scheduled_sends/{batch_id}).

Delete a cancellation/pause to resume sending (DELETE /user/scheduled_sends/{batch_id}).

Create an Event Webhook (POST /user/webhooks/event/settings).

Get all Event Webhooks (GET /user/webhooks/event/settings/all).

Get a single Event Webhook (GET /user/webhooks/event/settings/{id}).

Update an Event Webhook (PATCH /user/webhooks/event/settings/{id}).

Delete an Event Webhook (DELETE /user/webhooks/event/settings/{id}).

Test event notification settings (POST /user/webhooks/event/test).

Toggle signature verification; returns public key (PATCH /user/webhooks/event/settings/signed/{id}).

Get the signed Event Webhook public key (GET /user/webhooks/event/settings/signed/{id}).

Create an Inbound Parse setting (POST /user/webhooks/parse/settings).

Retrieve all parse settings (GET /user/webhooks/parse/settings).

Retrieve a specific parse setting (GET /user/webhooks/parse/settings/{hostname}).

Update a parse setting (PATCH /user/webhooks/parse/settings/{hostname}).

Delete a parse setting (DELETE /user/webhooks/parse/settings/{hostname}).

Retrieve Inbound Parse usage statistics (GET /user/webhooks/parse/stats).

Retrieve all bounces (GET /suppression/bounces).

Retrieve a specific bounce (GET /suppression/bounces/{email}).

Delete bounces (DELETE /suppression/bounces).

Delete a specific bounce (DELETE /suppression/bounces/{email}).

Retrieve all blocks (GET /suppression/blocks).

Retrieve a specific block (GET /suppression/blocks/{email}).

Delete blocks (DELETE /suppression/blocks).

Delete a specific block (DELETE /suppression/blocks/{email}).

Retrieve all spam reports (GET /suppression/spam_reports).

Retrieve a specific spam report (GET /suppression/spam_reports/{email}).

Delete spam reports (DELETE /suppression/spam_reports).

Delete a specific spam report (DELETE /suppression/spam_reports/{email}).

Retrieve all invalid emails (GET /suppression/invalid_emails).

Retrieve a specific invalid email (GET /suppression/invalid_emails/{email}).

Delete invalid emails (DELETE /suppression/invalid_emails).

Delete a specific invalid email (DELETE /suppression/invalid_emails/{email}).

Retrieve all global unsubscribes (GET /suppression/unsubscribes).

Add address(es) to the global suppression (POST /asm/suppressions/global).

Check if an email is globally suppressed (GET /asm/suppressions/global/{email}).

Delete a global suppression (DELETE /asm/suppressions/global/{email}).

Create a suppression (unsubscribe) group (POST /asm/groups).

Retrieve all suppression groups (GET /asm/groups).

Get a single group (GET /asm/groups/{group_id}).

Update a group (PATCH /asm/groups/{group_id}).

Delete a group (DELETE /asm/groups/{group_id}).

Add suppressions to a group (POST /asm/groups/{group_id}/suppressions).

Retrieve all suppressions in a group (GET /asm/groups/{group_id}/suppressions).

Search suppressions within a group (POST /asm/groups/{group_id}/suppressions/search).

Retrieve all suppressions across groups (GET /asm/suppressions).

Retrieve all groups an email is suppressed from (GET /asm/suppressions/{email}).

Delete an address from a group (DELETE /asm/groups/{group_id}/suppressions/{email}).

Create a transactional template (POST /templates).

Retrieve paged transactional templates (GET /templates).

Retrieve a single template (GET /templates/{template_id}).

Edit a template (PATCH /templates/{template_id}).

Delete a template (DELETE /templates/{template_id}).

Duplicate a template (POST /templates/{template_id}/duplicate).

Create a new template version (POST /templates/{template_id}/versions).

Retrieve a specific version (GET /templates/{template_id}/versions/{version_id}).

Edit a version (PATCH /templates/{template_id}/versions/{version_id}).

Delete a version (DELETE /templates/{template_id}/versions/{version_id}).

Activate a version (POST /templates/{template_id}/versions/{version_id}/activate).

Send a transactional email via SendGrid (POST /mail/send). Returns 202 Accepted; final delivery state arrives via the Event Webhook.

Generate a batch_id for grouping scheduled messages (POST /mail/batch).

Validate / retrieve a batch id (GET /mail/batch/{batch_id}).

Stats by category, 13-month window (GET /categories/stats).

Category stat sums (GET /categories/stats/sums).

Stats by client type (GET /clients/stats).

Stats for a specific client type (GET /clients/{client_type}/stats).

Stats by browser (GET /browsers/stats).

Stats by device type (GET /devices/stats).

Stats by country and state/province (GET /geo/stats).

Stats by mailbox provider (GET /mailbox_providers/stats).

Retrieve global email statistics (GET /stats).

Validate a single email address; Pro/Premier only (POST /validations/email).