Skip to content
Schedule Social Media

Press Esc to close.

New feature X Severity: medium

Account Activity API v2 accepts OAuth 2.0 with fine-grained scopes

Announced15 Jan 2026
Effective15 Jan 2026
StatusIn effect

What changed

On January 15, 2026 X added full OAuth 2.0 support to Account Activity API v2. Developers can create subscriptions with OAuth 2.0 and fine-grained scopes instead of the all-or-nothing OAuth 1.0a permission model. Existing OAuth 1.0a integrations keep working, and when OAuth 1.0a permissions are present they fully override OAuth 2.0 scopes.

What it means

Apps that connect X accounts with OAuth 2.0 can subscribe those accounts to Account Activity webhooks without also holding OAuth 1.0a tokens.

Who is affected

Developers of inbox, engagement and scheduling tools that use Account Activity API v2 webhooks.

What to do by 15 Jan 2026

Create Account Activity subscriptions with OAuth 2.0 user tokens and only the scopes you need. Note that OAuth 1.0a permissions, when present, fully override OAuth 2.0 scopes.

What this means for you

When you connect X to an app, the app gets a key that says what it may do. X has an older key type and a newer one. Its live-alerts service for accounts used to need the older one, which grants everything or nothing. Now it accepts the newer key, which can ask for just what it needs. You might see a narrower permission screen.

The details

  • What changed: Account Activity API v2 subscriptions can be created with OAuth 2.0 user context and fine-grained scopes. The changelog's example scope is follow.read; the OAuth 2.0 scopes table lists it as follows.read.
  • Precedence: existing OAuth 1.0a integrations "continue to work without disruption", and when present, OAuth 1.0a permissions fully override OAuth 2.0 scopes.
  • App-level calls (listing and deleting subscriptions, subscription count) and the /2/webhooks management endpoints use an OAuth 2.0 App Only Bearer Token.
  • Webhook signatures: the Webhooks introduction recommends verifying X-Twitter-Webhooks-Signature-OAuth2, computed with the app's OAuth 2.0 client secret. X-Twitter-Webhooks-Signature (OAuth 1.0 consumer secret) stays for backward compatibility.
  • Doc mismatch: the Account Activity introduction's FAQ still says subscribing a user requires OAuth 1.0a.
  • Deprecation: the same introduction says the Account Activity API "is being deprecated" in favour of the X Activity API, with no date given.

What to do next

  • Business owners: Nothing.
  • Marketers and agencies: Nothing.
  • Developers: Use OAuth 2.0 tokens for new Account Activity subscriptions, verify the OAuth 2.0 signature header, and plan the move to the X Activity API.

Primary sources

Checked against the source 7 Nov 2026

Get an email when a new API change is added

Follow new entries with the RSS feed. Each platform also has its own feed, for example X or Meta.