Below you can find the instructions for how to delete Message Streams, Postmark Servers, Postmark Users, Sender Signature email addresses, and sending Domains. 

🔒 Note that each requires specific user permission levels!

---

How to delete Message Streams

🔒  Required User Permission Level: Account Owner, Account Admin, Server Admin

While Message Streams cannot be immediately deleted, they can be archived. They'll then be automatically deleted after 45 days. During that 45 day window, you'll be able to restore the Message Stream if needed. You can archive a Message Stream within the UI or the API.

⚠️ Note! You are not able to archive a Server's default Transactional Message Stream, Default Broadcast Message Stream, or its Inbound Message Stream.

Archive a Message Stream in the UI

1. Login to the Postmark account
2. Click on the Server that contains the Message Stream in question
3. Click on the Message Stream you'd like to archive
4. Click the Settings tab
5. At the bottom of the Settings tab click the red "Archive Message Stream" button
6. Confirm by clicking the "OK" button

The Message Stream is now archived for 45 days, after which it'll be automatically deleted. 

If you'd like to restore an archived stream within those 45 days you can click into the Server in question and click the "View archived Message Streams" button. There, you'll be able to click the "Restore" button for any archived streams.

Archive a Message Stream Using the API

1. Use the GET /message-streams endpoint to pull a list of a Server's Message Streams
2. From the response, take the stream_ID value for the Message Stream you'd like to archive
3. Use the stream_ID value with the POST /message-streams/{stream_ID}/archive endpoint
4. Review the API response to ensure the Message Stream is now archived

The Message Stream is now archived for 45 days, after which it'll be automatically deleted. If you'd like to restore an archived stream within those 45 days you can do so within the UI or by using the POST /message-streams/{stream_ID}/unarchive endpoint .

---

How to delete a Postmark Server

🔒  Required User Permission Level: Account Owner, Account Admin, Server Admin 

Think of Servers as folders that help you organize your email in Postmark. (  “Why didn’t you call them folders, then?” Yeah, we really should have. But now they’re called Servers, and that term is all over our API, and changing it would be… complicated. Sorry, friends.)

Instead of deleting a Server, which by extension would delete all of its message streams and activity permanently, we recommend: 

1. Archiving the message stream(s) within that Server you no longer need
2. Rotating your API key(s) for your Server
3. Removing any unwanted user permissions for that Server
4. Updating the Server's name and other general settings to reflect its previous or new use

If you find a need to fully delete a Postmark Server, reach out to our team with details about your issue so we can help.

---

How to delete Postmark account users

🔒 Required User Permission Level: Account Owner, Account Admin

Users can only be deleted within the UI (there is currently no API endpoint for managing users).

1. Login to the Postmark account
2. Click on the Users tab at the top of the account
3. Click on the User that you wish to delete
4. Click the red "Delete user" button
5. Enter your login password and click the "Delete user" button to confirm deletion

⚠️ Note that an Account Owner cannot be deleted. Instead, the Account Owner must first transfer ownership to an existing Account Admin. More on that process here. 

---

How to delete Sender Signatures and Domains

🔒  Required User Permission Level: Account Owner, Account Admin

You can delete Sender Signature email addresses and sending Domains within the UI or using the API

How to delete Sender Signatures/Domains in the UI

1. Login to the Postmark account
2. Click the Sender Signatures tab at the top of the account
3. Click the 🗑️ icon next to the Sender Signature email address or sending Domain you wish to delete
4. Click the red button to confirm deletion

How to delete a Sender Signature email address using the API

1. Use the GET /senders endpoint to pull a list of the account's Sender Signatures
2. From the response, take the ID value for the Sender Signature you'd like to delete
3. Use the ID value with the DELETE /senders/{signatureid} endpoint
4. Review the API response to ensure the Sender Signature is now removed (deleted)

How to delete a sending Domain using the API

1. Use the GET /domains endpoint to pull a list of the account's sending Domains
2. From the response, take the ID for the sending Domain you'd like to delete
3. Use the ID value with the DELETE /domains/{domainid} endpoint
4. Review the API response to ensure the sending Domain is now removed (deleted)

---

🙋 Have any questions?

Don't hesitate to reach out to our support team with any questions about the above, or anything else. We're happy to help!