SendGrid Email docs

SendGrid Email API reference

Email send, delivery stats, and bounce suppression lists

/api/sendgrid3 endpointsPagination + delay readyDownload OpenAPI JSONDownload OpenAPI YAMLDownload Postman Collection

Endpoints

Pick the route you want to test.

3 routes

Active selection

POST

/api/sendgrid/v3/mail/send

Sample request

JAVASCRIPT example
1const payload = {
2  "from": {
3    "email": "noreply@fakeapifordevs.com"
4  },
5  "subject": "Preview deployment ready",
6  "personalizations": [
7    {
8      "to": [
9        {
10          "email": "dev@example.com"
11        }
12      ]
13    }
14  ],
15  "content": [
16    {
17      "type": "text/plain",
18      "value": "Your Fake API for Devs preview is ready."
19    }
20  ]
21}
22fetch('https://fakeapifordevs.vercel.app/api/sendgrid/v3/mail/send?page=1&per_page=5&delay=1', {
23  method: 'POST',
24  headers: { 'Content-Type': 'application/json' },
25  body: JSON.stringify(payload)
26})
27  .then(res => res.json())
28  .then(console.log)

Response contract

List responses include pagination metadata and can surface latency information when you add the `delay` query parameter.

Sample response
1{
2  "data": [
3    {
4      "message_id": "sg_mock_001",
5      "status": "accepted",
6      "recipient_count": 1,
7      "id": "undefined-1"
8    },
9    {
10      "message_id": "sg_mock_001",
11      "status": "accepted",
12      "recipient_count": 1,
13      "id": "undefined-2"
14    }
15  ],
16  "pagination": {
17    "page": 1,
18    "perPage": 5,
19    "total": 42,
20    "totalPages": 9
21  },
22  "meta": {
23    "delayMs": 0
24  }
25}

Query controls

These parameters are supported consistently across collection routes.

page

1-indexed page number. Defaults to 1.

per_page

Number of records per page. Defaults to 10, max 50.

q

Optional text search against names, titles, descriptions, or tags where supported.

delay

Simulate latency in seconds (max 10s).

simulate_error

Force realistic failures like 429, 500, 401, or 503 for resilience testing.

pagination_style

Switch between page, cursor, and link-style pagination on supported collections.

cors

Use `cors=restrict` or `cors=preflight` to test browser integration edge cases.

Integration checklist

  • Use `page` and `per_page` when you need predictable list states.
  • Append `delay` to mimic loading and partial-rendering moments.
  • Point internal examples and SDKs to `/api/sendgrid`.
  • Deep-link the selected method and path when sharing review links.

Playground shortcut

Open the landing page playground with this exact route already selected.

Open playground

https://fakeapifordevs.vercel.app/api/sendgrid/v3/mail/send?page=1&per_page=5&delay=1

Need another domain?

Explore the rest of the library without leaving the docs system.

AuthenticationE-commerceReal EstateSocial MediaFood DeliverySaaS

Keep these docs online

Buy the maintainers a coffee

Coffee donations help us keep SendGrid Email accurate, readable, and easier to test with every release.

  • Covers upkeep for sendgrid docs
  • Funds schema QA sprints
Buy us a coffee

Explore other domains

AuthenticationE-commerceReal EstateSocial MediaFood DeliverySaaSLogisticsPayments