SparkPost · Example Payload

Sparkpost Suppression Bulk Example

Example: Bulk insert suppressions for unsubscribed recipients

EmailTransactional EmailMarketing EmailEmail DeliverySMTPWebhookAnalyticsTemplatesSuppression List

Sparkpost Suppression Bulk Example is an example object payload from SparkPost, with 3 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

descriptionrequestresponse

Example Payload

{
  "description": "Example: Bulk insert suppressions for unsubscribed recipients",
  "request": {
    "method": "PUT",
    "url": "https://api.sparkpost.com/api/v1/suppression-list",
    "headers": {
      "Authorization": "YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    "body": {
      "recipients": [
        {
          "recipient": "unsubscribed@example.com",
          "type": "non_transactional",
          "description": "User requested unsubscribe via email footer"
        },
        {
          "recipient": "bounced@example.com",
          "type": "transactional",
          "description": "Hard bounce — address does not exist"
        },
        {
          "recipient": "complained@example.com",
          "type": "non_transactional",
          "description": "Spam complaint via Yahoo FBL"
        }
      ]
    }
  },
  "response": {
    "status": 200,
    "body": {}
  }
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this

find_examplesBrowse and filter every example in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This example

curl "https://apis.io/api/v1/examples/sparkpost-suppression-bulk-example"

All examples

curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.