XDMs

✓

Logged in with X

Done

2

Import your DM history

X gives you a free, complete download of your DM history. Request it, then come back and upload just the small DM text files here — we backfill everything at no API cost. (It's a snapshot; messages the other person deleted won't be included.)

1 Request your archive on X

Open X → Settings → Your account → Download an archive of your data.
Verify your identity, then click Request archive.
X emails you a download link when it's ready — usually a few hours, up to a day or two.

2 Open the archive & find the data folder

The download is one big .zip — mostly media, so don't upload the whole thing. Open it and go into the data folder; you'll pick specific files from there below.

Mac (Finder): double-click the .zip → open the new unzipped folder → open the data folder.

Windows (File Explorer): right-click the .zip → Open (not "Extract All") → open the data folder.

3 Choose each file from the data folder

Pick one file at a time — we check each is the correct file as you go.

account.js required

Confirms the archive belongs to your account.

direct-messages.js required

Your 1:1 Direct Messages.

direct-messages-group.js optional

Your group chats — skip if you don't need them.

3

Connect your developer app for DM access

Later

Login proved who you are. Now authorize XDMs to read & send DMs for your account. One click — no keys to paste.

You'll approve dm.read dm.write + offline access for your X account, and we verify it's the same account you logged in as. Tokens are stored encrypted and are revocable anytime in your X settings → Connected apps. Sends always go out from your own X identity.

DM access connected Send limit: —

✓

You're all set

Setup complete. Search, AI drafting and approve-&-send are rolling out next — each unlocks here as we ship it.

Get set up

Logged in with X

Import your DM history

Connect your developer app for DM access

You're all set