---
title: How do I update the suppression list via API on Opensend?
description: Keep your suppression list up-to-date automatically and in real-time via our API. Integrate either directly, or via Zapier (see below).
---

[Skip to content](https://help.opensend.com/how-do-i-update-suppression-list-via-api-on-opensend#main-content)

[Contact Support](https://help.opensend.com/kb-tickets/new?hsLang=en)

[![Logo Black.png\]](https://help.opensend.com/hs-fs/hubfs/Logo%20Black.png?height=33&name=Logo%20Black.png)](https://opensend.com/)

Open main navigation

Close main navigation

- [Contact Support](https://help.opensend.com/kb-tickets/new)
- [Return to opensend.com](https://opensend.com/)

[Return to opensend.com](https://opensend.com/)

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Success Center](https://help.opensend.com/?hsLang=en)
2. [Integrations](https://help.opensend.com/integrations?hsLang=en)
3. [Suppression List](https://help.opensend.com/integrations?hsLang=en#suppression-list)

# How do I update the suppression list via API on Opensend?

## Keep your suppression list up-to-date automatically and in real-time via our API. Integrate either directly, or via Zapier (see below).

**Prerequisites:** 

To update the suppression list via API on Opensend you will need:

1. API-KEY: Please follow [this guide](https://help.opensend.com/opensend-api-keys?hsLang=en) to get your API-KEY
2. PUBLICID: Please follow [this guide](https://help.opensend.com/opensend-account-ids?hsLang=en) to get your PUBLICID

Once you have these, emails can be added to your Opensend suppression list by sending a POST request to our endpoint, containing API-KEY, PUBLICID, and email address.

**Guide on direct API Integration:**

**Samples:**

- For a single email address in plain text

```
curl -i -X POST "https://api.opensend.com/suppression" \     -H 'x-api-key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \     -H "Content-Type: application/json" \       -d '{"clientId" : "XXXXXXXX", "email": "testsuppression@gmail.com"}'
```

- For the multiple email addresses in plain text

```
curl -i -X POST "https://api.opensend.com/suppression" \     -H 'x-api-key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \     -H "Content-Type: application/json" \       -d '{"clientId" : "XXXXXXXX", "emails": ["test1@test.com", "test2@test.com"]}
```

**Notes on Hashed Suppression:**

- - Supported hash types: MD5, SHA-1, SHA-256.

- For a single hashed email address

```
curl -i -X POST "https://api.opensend.com/suppression" \     -H 'x-api-key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \     -H "Content-Type: application/json" \       -d '{"clientId": "XXXXXXXX", "hash": "d93d6f9e9f5d0965450fbdb2f4a53d45"}'
```

- For the multiple hashed email addresses

```
curl -i -X POST "https://api.opensend.com/suppression" \     -H 'x-api-key: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \     -H "Content-Type: application/json" \       -d '{"clientId": "XXXXXXXX", "hashes": ["d93d6f9e9f5d0965450fbdb2f4a53d45", "d93d6f9e9f5d0965450fbdb2f4a53d45"]}'
```

**API endpoint**

```
https://api.opensend.com/suppression
```

**Header**

```
x-api-key: API-KEYContent-Type: application/json
```

**Input(Standard with an email in plain text)**

```
{"clientId" :"PUBLICID", "email": "test@domain.com"}
```

**Result**

```
{"status": "Success."}
```

**Guide on using Suppression List API Integration with Zapier:**

1. Login to your Zapier account and click on the “Create Zap” button from the left bar on the dashboard.   
   ![33](https://help.opensend.com/hs-fs/hubfs/33.png?width=688&height=413&name=33.png)
2. From the top left click on the edit icon to add the name of Zap  “Opensend Suppression List”.  
   ![](https://help.opensend.com/hs-fs/hubfs/image-png-Feb-05-2024-12-29-06-8031-PM.png?width=585&height=76&name=image-png-Feb-05-2024-12-29-06-8031-PM.png)
3. Click on "Trigger". Then under the trigger search bar, search for the Email marketing platform or another tool you want to use as the source of the suppression list e.g. "Google Sheets"  
   **Note:** Using Google sheet as a trigger is just an example and in your case, you can use the trigger of your choice, it should be the platform where you have your contacts to be uploaded to the suppression list.
   
   ![](https://help.opensend.com/hs-fs/hubfs/image-png-Feb-05-2024-12-32-29-8982-PM.png?width=688&height=252&name=image-png-Feb-05-2024-12-32-29-8982-PM.png)
4. Under event select  "New Spreadsheet Row", and click "Continue"
   
   ![](https://help.opensend.com/hs-fs/hubfs/image-png-Feb-05-2024-12-37-53-0666-PM.png?width=538&height=398&name=image-png-Feb-05-2024-12-37-53-0666-PM.png)
5. Under the account option please authenticate the Google Sheet account to integrate, and click "Continue"  
   ![](https://help.opensend.com/hs-fs/hubfs/image-png-Feb-05-2024-12-42-37-8331-PM.png?width=543&height=342&name=image-png-Feb-05-2024-12-42-37-8331-PM.png)
6. Under Trigger select the relevant Spreadsheet and Worksheet, you plan to use to upload to the suppression list, and click "Continue"  
   ![](https://help.opensend.com/hs-fs/hubfs/image-png-Feb-05-2024-12-45-02-5663-PM.png?width=532&height=486&name=image-png-Feb-05-2024-12-45-02-5663-PM.png)
7. Under Test, Click "Test trigger"  
   ![](https://help.opensend.com/hs-fs/hubfs/image-png-Feb-05-2024-12-46-12-7363-PM.png?width=511&height=419&name=image-png-Feb-05-2024-12-46-12-7363-PM.png)
8. Select a record from the sheet that will be used for mapping out the fields in the next steps and Click "Continue with selected record"  
   ![](https://help.opensend.com/hs-fs/hubfs/image-png-Feb-05-2024-12-48-05-9395-PM.png?width=512&height=492&name=image-png-Feb-05-2024-12-48-05-9395-PM.png)
9. In the next step, under the action search bar, search for "Webhooks by Zapier" and select that  
   ![](https://help.opensend.com/hs-fs/hubfs/image-png-Feb-05-2024-12-50-26-2505-PM.png?width=500&height=367&name=image-png-Feb-05-2024-12-50-26-2505-PM.png)
10. Under Event, select "Custom Request" and, Click "Continue"  
    ![](https://help.opensend.com/hs-fs/hubfs/image-png-Feb-05-2024-12-51-54-5300-PM.png?width=537&height=345&name=image-png-Feb-05-2024-12-51-54-5300-PM.png)
11. Under Action, make the following changes: 
      1. Select "Post" under Method dropdown
      2. URL: `https://api.opensend.com/suppression`
      3. Select "False" under Data Pass-Through dropdown
      4. Data: {"clientId" :"\[Your PublicID provided by Opensend\]", "email": "\[choose email field from Trigger\]"}
      5. Headers:   
         "x-api-key"  with value \[API key provided by Opensend\]  
         "Content-Type" with value "application/json"
         
         ![](https://help.opensend.com/hs-fs/hubfs/image-png-Apr-02-2025-11-43-37-8564-AM.png?width=650&height=747&name=image-png-Apr-02-2025-11-43-37-8564-AM.png)
12. Click Continue
13. Click "Test Step"  
    ![](https://help.opensend.com/hs-fs/hubfs/image-png-Feb-05-2024-01-06-29-3057-PM.png?width=430&height=70&name=image-png-Feb-05-2024-01-06-29-3057-PM.png)  
    Note: You can verify if the Zap is working as expected by visiting the Suppression list tab on the Opensend Dashboard and seeing the test email added there.  
    ![](https://help.opensend.com/hs-fs/hubfs/image-png-Feb-05-2024-01-09-30-6053-PM.png?width=667&height=368&name=image-png-Feb-05-2024-01-09-30-6053-PM.png)
14. Under Test, Click "Publish"  
    ![](https://help.opensend.com/hs-fs/hubfs/image-png-Feb-05-2024-01-10-29-3906-PM.png?width=445&height=634&name=image-png-Feb-05-2024-01-10-29-3906-PM.png)

 

 

- [Getting started](https://help.opensend.com/getting-started?hsLang=en#main-content)

    - [Start Here!](https://help.opensend.com/getting-started?hsLang=en#start-here)
    - [Installation and Setup](https://help.opensend.com/getting-started?hsLang=en#installation-and-setup)
    - [CNAME Setup](https://help.opensend.com/getting-started?hsLang=en#cname-setup)
    - [Opensend SDK](https://help.opensend.com/getting-started?hsLang=en#opensend-sdk)
- [Best Practices to Maximize Revenues](https://help.opensend.com/best-practices-to-maximize-revenues?hsLang=en#main-content)

    - [Direct-to-consumer](https://help.opensend.com/best-practices-to-maximize-revenues?hsLang=en#direct-to-consumer)
    - [Business-to-business](https://help.opensend.com/best-practices-to-maximize-revenues?hsLang=en#business-to-business)
    - [Deliverability](https://help.opensend.com/best-practices-to-maximize-revenues?hsLang=en#deliverability)
- [Dashboards & Reports](https://help.opensend.com/dashboards-reports?hsLang=en#main-content)

    - [Klaviyo Reports](https://help.opensend.com/dashboards-reports?hsLang=en#klaviyo-reports)
    - [Iterable Reports](https://help.opensend.com/dashboards-reports?hsLang=en#iterable-reports)
- [Reconnect](https://help.opensend.com/reconnect?hsLang=en#main-content)

    - [Klaviyo](https://help.opensend.com/reconnect?hsLang=en#klaviyo)
    - [Iterable](https://help.opensend.com/reconnect?hsLang=en#iterable)
    - [Bloomreach](https://help.opensend.com/reconnect?hsLang=en#bloomreach)
    - [Attentive](https://help.opensend.com/reconnect?hsLang=en#attentive)
    - [Salesforce Marketing Cloud](https://help.opensend.com/reconnect?hsLang=en#salesforce-marketing-cloud)
- [Personas](https://help.opensend.com/personas?hsLang=en)
- [Revive](https://help.opensend.com/revive?hsLang=en)
- [Integrations](https://help.opensend.com/integrations?hsLang=en#main-content)

    - [API Keys and Account IDs](https://help.opensend.com/integrations?hsLang=en#api-keys-and-account-ids)
    - [Bloomreach](https://help.opensend.com/integrations?hsLang=en#bloomreach)
    - [Braze](https://help.opensend.com/integrations?hsLang=en#braze)
    - [Facebook](https://help.opensend.com/integrations?hsLang=en#facebook)
    - [Google](https://help.opensend.com/integrations?hsLang=en#google)
    - [Iterable](https://help.opensend.com/integrations?hsLang=en#iterable)
    - [Klaviyo](https://help.opensend.com/integrations?hsLang=en#klaviyo)
    - [Listrak](https://help.opensend.com/integrations?hsLang=en#listrak)
    - [Sendlane](https://help.opensend.com/integrations?hsLang=en#sendlane)
    - [Suppression List](https://help.opensend.com/integrations?hsLang=en#suppression-list)
    - [Webhook](https://help.opensend.com/integrations?hsLang=en#webhook)
    - [Yotpo](https://help.opensend.com/integrations?hsLang=en#yotpo)
    - [Zapier](https://help.opensend.com/integrations?hsLang=en#zapier)
    - [Attentive](https://help.opensend.com/integrations?hsLang=en#attentive)
    - [Salesforce Marketing Cloud](https://help.opensend.com/integrations?hsLang=en#salesforce-marketing-cloud)
- [FAQs](https://help.opensend.com/faqs?hsLang=en)
- [General](https://help.opensend.com/general?hsLang=en)

[![Chill listening crop-3](https://help.opensend.com/hs-fs/hubfs/OpenSend_Logo%20icon%202.png?width=42&height=42&name=OpenSend_Logo%20icon%202.png "Chill listening crop-3")](https://www.opensend.com/)

Opensend Help Center

Copyright © 2026, Opensend Inc