DEV Community

Cover image for How to declare Twitter DM bankruptcy

Posted on • Originally published at

How to declare Twitter DM bankruptcy

Look, we get it. You have too many messages and it's easier to lock down your DMs than respond to all of them. But is that the solution?

Why declare DM bankruptcy

First off, congrats! You are popular on Twitter, popular enough to get a lot of the benefits that come from having a larger audience.

You can ask questions out into a void and actually get responses. When you tweet out a link to a project you're working on, people actually give you feedback. Amazing!

But what about the downsides?

Well, first off โ€” sorry about the reply-guys. We can't fix those.

The Twitter DM UX is not great, but you probably already knew that. But on the bright side, some of the DMs you get are super awesome. Thoughtful internet strangers are the best type of strangers.

So how do you handle the bad DM UX?

One option is to declare DM bankruptcy and funnel all well-meaning followers to contact you via email. Even though your email is still public, this extra step often stops most junk but allows for incoming messages if the sender cares enough.

Decided you want to declare DM bankruptcy? Okay, let's get started.

The steps

1. Write a tweet

Filing for Twitter bankruptcy is considerably easier than the real thing. First, write a tweet as Kelly did above, letting your followers know that you won't be responding to their DMs.

Be sure to include your email. Bonus points for using an email provider like, which lets you control who can and cannot message you.

2. Pin your bankruptcy tweet

Next, pin your bankruptcy tweet to your Twitter profile. Only a fraction of your followers see the bankruptcy tweet when you post it, so pinning it to your profile is important to keep all your followers in the loop.

3. Create an automated DM with Twitter's API (optional)

Okay, so now we're getting into the really cool part. This is the problem solves, but I'm going to show you how to do it using Twitter's API instead.

First, what's a Twitter welcome message?

So Twitter created welcome messages to help brands deal with the large influx of DMs they get. They just never rolled it out to you and me.

But, it's in their API docs.

Let's use it.

Set up Twurl

Twurl is a lot like curl, except it's specifically for querying the Twitter API. Configure it once for auth and you're good to go.

Okay, so we're going to be using RubyGems to install Twurl.

First, run:

gem install twurl
Enter fullscreen mode Exit fullscreen mode

Apply for Twitter developer access

The next step is to apply for access to the API. Do that here:

Generate tokens

After you've been accepted (which should happen rather quickly), you'll need to generate and set up your tokens for Twurl.

To do that, head to the portal here:

I've already got a few apps, but this section will be empty for you. Click the "Create App" button.

Name that app whatever you're feeling like (but it does have to be unique globally).

Authorize Twurl

Next, you need to configure Twurl to pass your secrets that you just created on the last step, like this:

twurl authorize --consumer-key key       \
                --consumer-secret secret
Enter fullscreen mode Exit fullscreen mode

Test out Twurl to be sure it's working:

twurl /1.1/statuses/home_timeline.json
Enter fullscreen mode Exit fullscreen mode

Create your welcome message

Now that we're configured, let's start creating your automated welcome message.

Head over to the Twitter docs if you'd like a more detailed explanation of what we're doing.

Each page of Twitter API documentation normally comes with a copy-and-paste ready Twurl example.

twurl -A 'Content-type: application/json' /1.1/direct_messages/welcome_messages/new.json -d '{"name": "simple_welcome-message 01", "welcome_message": {"message_data": {"text": "Your welcome message goes here!"}}}'
Enter fullscreen mode Exit fullscreen mode

The response should look something like this:

  "welcome_message": {
    "id": "1375945329892278289",
    "created_timestamp": "1616885905131",
    "message_data": {
      "text": "Your welcome message goes here!",
      "entities": {
        "hashtags": [],
        "symbols": [],
        "user_mentions": [],
        "urls": []
    "source_app_id": "19958039"
  "apps": {
    "19958039": {
      "id": "19958039",
      "name": "Twurl Drew Local"
Enter fullscreen mode Exit fullscreen mode

After you create it, be sure to take note of the welcome message id, you'll need this later.

Creating a welcome message rule

Welcome message rules are what makes Twitter automatically show someone a welcome message when they message you for the first time.

Be sure to use the id from the last step.

twurl -A 'Content-type: application/json' -X POST /1.1/direct_messages/welcome_messages/rules/new.json -d '{"welcome_message_rule": {"welcome_message_id": "YOUR_ID_FROM_LAST_STEP"}}'
Enter fullscreen mode Exit fullscreen mode

Now when someone new messages you, they'll see this message automatically directing them to email you instead. Now you don't have to use that precious pinned tweet space to inform people you're not checking your DMs!

Is there an easier option?

Sometimes mucking around with the API isn't fun, I get that. That's why I've been building a tool to help everyone create these Twitter Welcome messages.

We're building to help make declaring Twitter bankruptcy as easy as possible.

The ability to create Twitter welcome messages is on our free tier.

Comment on this post and I'll reach out to you when we launch later this week.

Top comments (0)