Mailchimp Developer LogoMailchimp Developer Wordmark

Transactional API

  • Allowlists

    Add, list, or delete from your Rejection Allowlist.

    • Exports

      Start an export, or get information on export jobs in progress.

      • IPs

        Request and manage Dedicated IPs for your account, and set up reverse DNS.

        • Inbound

          Manage your inbound domains and routes.

          • Messages

            Send, schedule, or get information on your emails.

            • Metadata

              Manage your custom metadata fields in your account.

              • Rejects

                Add, list, or delete from your Rejection Denylist.

                • Senders

                  Manage or get information about your sending domains.

                  • Subaccounts

                    Manage your subaccounts, including the abilitiy to pause and resume sending.

                    • Tags

                      List, delete, or get information on your Tags and their sending statistics.

                      • Delete tag

                        post

                        /tags/delete

                        Deletes a tag permanently. Deleting a tag removes the tag from any messages that have been sent, and also deletes the tag's stats. There is no way to undo this operation, so use it carefully.

                        body parameters

                        • keyrequired
                          string

                          a valid api key

                        • tagrequired
                          string

                          a tag name

                        Delete tag

                        const mailchimpClient = require("@mailchimp/mailchimp_transactional")(
                          "YOUR_API_KEY"
                        );
                        
                        const run = async () => {
                          const response = await mailchimpClient.tags.delete({ tag: "tag" });
                          console.log(response);
                        };
                        
                        run();
                        
                        

                        Success Response

                        • HTTP Status 200

                          the tag that was deleted

                          • tag
                            string

                            the actual tag as a string

                          • reputation
                            integer

                            the tag's current reputation on a scale from 0 to 100.

                          • sent
                            integer

                            the total number of messages sent with this tag

                          • hard_bounces
                            integer

                            the total number of hard bounces by messages with this tag

                          • soft_bounces
                            integer

                            the total number of soft bounces by messages with this tag

                          • rejects
                            integer

                            the total number of rejected messages with this tag

                          • complaints
                            integer

                            the total number of spam complaints received for messages with this tag

                          • unsubs
                            integer

                            the total number of unsubscribe requests received for messages with this tag

                          • opens
                            integer

                            the total number of times messages with this tag have been opened

                          • clicks
                            integer

                            the total number of times tracked URLs in messages with this tag have been clicked

                          • unique_opens
                            integer

                            the number of unique opens for emails sent with this tag

                          • unique_clicks
                            integer

                            the number of unique clicks for emails sent with this tag

                        Example response

                        JSON
                        {
                          "tag": "string",
                          "reputation": 0,
                          "sent": 0,
                          "hard_bounces": 0,
                          "soft_bounces": 0,
                          "rejects": 0,
                          "complaints": 0,
                          "unsubs": 0,
                          "opens": 0,
                          "clicks": 0,
                          "unique_opens": 0,
                          "unique_clicks": 0
                        }
                      • Templates

                        Manage the Templates in your account.

                        • URLs

                          Manage your tracking domains. Some of these endpoints may be deprecated.

                          • Users

                            Get information about your account, or ping Transactional.

                            • Webhooks

                              Manage the webhooks in your account.

                              • Whitelists

                                Add, list, or delete from your Rejection Allowlist. These endpoints are being replaced with a series of functionally identical endpoints called /allowlists.