How to Delete a Legacy Welcome Message from Twitter

Posted by

Over the last few years, I’ve had a number of people ping me on Twitter telling me that my email address ([email protected]) was invalid.

This was an email that I gave up in 2015. Whenever I asked them where they saw it, they would say Twitter DM.

In my Twitter inbox, I never saw anything. I went through all my third party apps that had access to my DMs and revoked all of them and yet, I still kept getting messages about my invalid email.

I decided to ping a Twitter Guru and friend, @askaaronlee – he told me that it was an official Twitter Welcome Message and not an automated DM.

This explained why I never saw it in my inbox. It was a “welcome message” that only showed itself to new followers who tried to DM me.

After much digging around, I found this in one of the threads in the Twitter Developer Forum:

“If an App isn’t the issue here, the only way you could create a Welcome Message was through Twitter’s official business features that have been discontinued. If you previously had a set Welcome Message active when the features were shut off, that Welcome Message would still be there and there would be no way to shut it off or delete it.

This happened to someone I know a few months ago and what I did to turn it off was to create a new Welcome Message through a 3rd-party bot platform and then delete it. This new Welcome Message pretty much overthrows the old one and deletes them entirely.”

That’s exactly what happened to me – I had set up a Welcome Message using Twitter’s Business Experience and now had no way of turning it off.

Using Twitter’s Developer API to Delete the Welcome Message

Luckily, fellow chatbot developer and friend Marc Littlemore (@marclittlemore) came to my assistance and helped me figure out a way to delete that legacy message.

The only way was to use Twitter’s Developer API to delete the message. If you’re a developer, you can find instructions here. https://developer.twitter.com/en/docs/direct-messages/welcome-messages/api-reference/new-welcome-message

If you’re not a developer, here are some instructions easy enough for you to follow.

1. Create a Twitter App

Go to https://developer.twitter.com/en/apps and create a new app with Write, Read and Direct Message Permissions.

2. Download Postman

Go to https://www.postman.com/ and download the free Postman app. Postman allows you to send GET, POST and DELETE requests via Twitter’s developer API.

3. In Postman send a GET request

to this endpoint https://api.twitter.com/1.1/direct_messages/welcome_messages/list.json and add authorisation (type = OAuth 1.0). Add authorisation data to “Request Headers”.

4. Add your Consumer Key / Secret and Access Token / Secret

These can be found when you created the Twitter app.

5. Click Send.

At the bottom, you will see the errant Welcome Message.

6. Copy the id of the welcome message.

7. Make an DELETE request to:

https://api.twitter.com/1.1/direct_messages/welcome_messages/destroy.json?id=
and append the ID number of the welcome message to the URL.

In this case, I used the end point:

https://api.twitter.com/1.1/direct_messages/welcome_messages/destroy.json?id=798741885590257667

8. Click SEND and your welcome message will be deleted!

Viola!