X Docs

X API v2 — Activity

Documentation for X Activity subscriptions now covers optional filter.qualifiers.

Introduction (/x-api/activity/introduction)

• Added a Filter qualifiers section describing the optional filter.qualifiers map (up to 8 string key/value entries).
• Documents supported qualifiers: conversation_type (direct, group) for chat.received, and direction (inbound, outbound) for follow.follow, follow.unfollow, and like.create.
• Notes that direction matches the existing top-level filter.direction field; both remain supported.
• Includes a sample create-subscription payload, response echo behavior, and 400 error messaging for invalid qualifier keys or values.

Quickstart (/x-api/activity/quickstart)

• Added a curl example that creates a chat.received subscription filtered to one-on-one chats via filter.qualifiers.conversation_type.
• Points to the introduction’s filter qualifiers reference for supported values and limits.

Create subscription (/x-api/activity/create-x-activity-subscription)

• Endpoint summary updated to note that optional filter.qualifiers can further narrow supported chat, follow, unfollow, and like events.