How to join a community on Twitter via API

{
  "object": "x_write_action",
  "id": "12345",
  "writeActionId": "12345",
  "action": "join_community",
  "status": "success",
  "terminal": true,
  "retryable": false,
  "safeToRetry": false,
  "statusUrl": "/api/v1/x/write-actions/12345",
  "pollAfterMs": null
}

{
  "object": "x_write_action",
  "id": "12346",
  "writeActionId": "12346",
  "action": "join_community",
  "status": "dispatching",
  "terminal": false,
  "retryable": false,
  "safeToRetry": false,
  "statusUrl": "/api/v1/x/write-actions/12346",
  "pollAfterMs": 2000
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check request fields.",
  "charged": false,
  "chargedCredits": "0",
  "retryable": false,
  "safeToRetry": true
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "account_needs_reauth",
  "message": "X account needs re-authentication. Re-add the account."
}

{
  "error": "account_not_found",
  "message": "X account not found. Connect it first at /dashboard/account?tab=x-accounts."
}

{
  "error": "idempotency_conflict",
  "message": "Idempotency-Key was already used with a different request.",
  "charged": false,
  "chargedCredits": "0",
  "retryable": false,
  "safeToRetry": true
}

{
  "error": "x_rejected",
  "message": "X rejected this request. Wait a few minutes and try again."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_write_failed",
  "message": "Write action failed unexpectedly. Contact support if this persists."
}

{
  "error": "write_tracking_unavailable",
  "message": "Write tracking unavailable. Try again.",
  "charged": false,
  "chargedCredits": "0",
  "retryable": true,
  "safeToRetry": true
}

POST

communities

{id}

join

How to join a community on Twitter via API

curl --request POST \
  --url https://xquik.com/api/v1/x/communities/{id}/join \
  --header 'Content-Type: <content-type>' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "account": "<string>"
}
'

import requests

url = "https://xquik.com/api/v1/x/communities/{id}/join"

payload = { "account": "<string>" }
headers = {
    "x-api-key": "<api-key>",
    "Idempotency-Key": "<idempotency-key>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-api-key': '<api-key>',
    'Idempotency-Key': '<idempotency-key>',
    'Content-Type': '<content-type>'
  },
  body: JSON.stringify({account: '<string>'})
};

fetch('https://xquik.com/api/v1/x/communities/{id}/join', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/communities/{id}/join"

	payload := strings.NewReader("{\n  \"account\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

10 credits per call · All plans from $0.00012/credit

curl -X POST https://xquik.com/api/v1/x/communities/1893726451023847424/join \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Idempotency-Key: community-join-1895432178065391234" \
  -H "Content-Type: application/json" \
  -d '{
    "account": "myxhandle"
  }' | jq

const response = await fetch(
  "https://xquik.com/api/v1/x/communities/1893726451023847424/join",
  {
    method: "POST",
    headers: {
      "x-api-key": "xq_YOUR_KEY_HERE",
      "Idempotency-Key": "community-join-1895432178065391234",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      account: "myxhandle",
    }),
  }
);
const data = await response.json();

import requests

response = requests.post(
    "https://xquik.com/api/v1/x/communities/1893726451023847424/join",
    headers={
        "x-api-key": "xq_YOUR_KEY_HERE",
        "Idempotency-Key": "community-join-1895432178065391234",
    },
    json={
        "account": "myxhandle",
    },
)
data = response.json()

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    body, _ := json.Marshal(map[string]interface{}{
        "account": "myxhandle",
    })

    req, err := http.NewRequest("POST", "https://xquik.com/api/v1/x/communities/1893726451023847424/join", bytes.NewReader(body))
    if err != nil {
        panic(err)
    }
    req.Header.Set("x-api-key", "xq_YOUR_KEY_HERE")
    req.Header.Set("Idempotency-Key", "community-join-1895432178065391234")
    req.Header.Set("Content-Type", "application/json")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var data map[string]interface{}
    if err := json.NewDecoder(resp.Body).Decode(&data); err != nil {
        panic(err)
    }
    fmt.Println(data)
}

How to join a community on Twitter through the API

Call POST /x/communities/{id}/join with one connected Twitter account and numeric ID. X decides whether that account can join. The route cannot discover, create, or moderate Communities. Approve each pair first.

Understand open, restricted, and invited membership

Open Communities allow direct joins. Restricted Communities may require approval or an invitation. X controls each membership mode. Open the Community page and review its rules. Use the join button for manual membership. Find it at the top of the page. Restricted Communities display Ask to join. A moderator decides that request. No API field selects a mode or accepts an invitation. Use the official X Communities guide for current interface behavior.

Find Twitter communities before joining

Existing members can open the Community tab on X.com or iOS. Search by name, description, creator, or handle. X warns that some Communities never appear in search results. Use a direct URL for an account’s first Community. Ask an owner or moderator for the exact link when search omits it. Confirm the specific Community name, description, rules, moderators, membership mode, and recent posts. Never approve membership from a similar display name. Match the numeric ID with Community Info. Community Search searches posts inside one known Community. It cannot find Community directories or topic-based groups.

Compare manual and API community joining

For manual membership, sign in to X and open the Community URL. Review the Community rules and membership mode. Select Join or Ask to join. Then wait for any required moderator review. For an API workflow, validate the connected Twitter account and numeric ID. Capture approval before submission. Poll the returned action. Verify the complete member roster after the action reaches a terminal state. X handles invitations, rules, and moderator review for both paths. The API cannot click controls, select a membership mode, or bypass moderator approval.

Review account eligibility and moderator limits

Confirm that the X account remains public and connected. Check existing membership and pending requests before submission. Reusing an existing action prevents duplicate membership requests. Admins and moderators enforce each Community’s rules. They review restricted requests. A block between the account and a moderator can stop membership. The API cannot override that relationship. X says an admin account must have a verified email address or phone number. This verified-contact requirement applies only to admins. Twitter Communities offer topic-focused spaces for members. Members use a dedicated space for one shared topic. The contract defines no separate community account. Store the connected account and Community ID as separate fields.

Choose the correct X relationship

Use Join Community for one approved membership.
Use Follow for one account relationship.
Use Create Tweet for an approved Community post.
Use Community Members to verify the roster.
Use Community Tweets to read the Community timeline.

Following, Lists, group messages, and Community Notes cannot change membership.

Plan post-join reading and publishing

Joining adds one connected account to one social media Community. It does not create posts, invitations, or moderator changes. Read Community Tweets after confirmation. Store Tweet IDs, replies, reposts, likes, media, and cursors. Use Community Search for keyword matches inside the reviewed Community ID. Read recent conversations before drafting a reply or media post. Membership never authorizes publishing. Approve separate Create Tweet actions for members posting after joining. Keep the reviewed rules with each approval. Avoid repetitive promotions and unwanted invitations. Moderators can remove accounts that violate local rules.

Resolve membership intent

Use a numeric Community ID. Record its connected account, membership mode, and approval. Keep enough evidence to explain every membership request.

Approval evidence	Store	Purpose
Intended Community	Numeric ID, display name, and direct URL	Prevent membership in a similarly named Community
Connected account	Username, stable user ID, and connection status	Bind consent to one Twitter account
Membership review	Mode, rules, and moderator status	Explain an open, pending, or rejected request
API action	Idempotency key, action ID, status URL, and final status	Prevent duplicate writes and preserve recovery state

How to join Twitter community membership safely

The steps below explain how to join Twitter Community membership through Xquik.

Review the numeric Community ID and connected account.
Create one pair-specific Idempotency-Key.
Submit POST /x/communities/{id}/join once.
Poll the returned action to a terminal result.
Verify the account through Community Members.
Store the action, approval, membership mode, and result.

An HTTP 202 confirms processing, not membership. If a timeout occurs, keep polling the existing action. A changed account or Community needs new approval. Store the request hash, action ID, status URL, and final membership result. Keep the same Idempotency-Key only when every input remains identical. A changed account, Community ID, or approval requires a new key.

Join communities in controlled batches

Assign one Idempotency-Key per approved pair. Process retries serially. Record each result, action ID, and approval in one durable ledger row. Pause only the affected account after errors.

Verify visible membership

After a terminal result, call Community Members. Follow every cursor. Store the Community ID, action status, matched username, and stable user ID. Never resubmit after checking only one page. Anyone with the direct Community URL can see its member list.

Explain community post visibility

Community posts are not private group messages. They can appear on Community pages, profiles, timelines, and search. Anyone on X with the direct Community URL can see the Community’s member list. Joining never publishes a post. Use Create Tweet after separate approval. Community membership is not a private audience. A Community post can appear on the Community page, its author’s profile, timelines, and search. Review that visibility before approving a post.

Answer common Twitter community questions

How to join a Twitter community with Xquik?

Review Community Info. Submit one connected account and numeric ID. Poll the action, then verify Community Members.

Can I join an invitation-only Twitter community?

For an invite-only Community, X still requires an invitation. Confirm you are logged in to your account on X. This endpoint cannot accept invitations. Preserve any 422 rejection.

What happens when you join a Twitter community?

X adds the membership after approval. Members can reply after X confirms membership. They can connect, share posts, and follow the Community’s rules.

Can people see the communities you join on Twitter?

Direct Community URLs expose member lists. Posts can also appear publicly.

How do I join a community on a phone?

Open a shared Community URL. Review its rules and membership mode. Use X for manual membership or Xquik for server workflows.

Do Twitter communities still exist?

Yes. X controls availability, search, membership modes, and moderation.

Do I need X Premium to join a community?

The request has no Premium field. X decides account eligibility.

Why can’t I join a Twitter community?

Check the public account, numeric ID, connection, mode, and invitation. Check whether the account and moderators block each other. Read terminal, retryable, and safeToRetry before retrying.

How do I find active Twitter communities by interest?

Search the Communities page by topic or creator after joining once. A first membership needs a shared URL. Community Search cannot find Community directories.

What are the benefits of joining a Twitter community?

Membership opens one topic-focused discussion space. Members can read its timeline and participate under its rules. This endpoint cannot promise followers, engagement, leads, or sales.

How should a brand participate after joining?

Read recent Community posts first. Match the topic and follow moderator rules. Approve each reply, post, and media upload separately. Avoid repetitive promotions and unwanted invitations.

Is community notes the same as X communities?

No. Community Notes adds context to posts. X Communities organize memberships and discussions. Use X to join Community Notes.

Can this API create, moderate, or grow a community?

No. Use Create Community for creation. Join Community cannot moderate, invite, or grow members.

Recover from join failures

Fix input after 400. Replace credentials after 401. Restore credits after 402. Reconnect the account after 403. Check both IDs after 404. Reuse the same key only for identical input after 409. Preserve 422 rejections. Honor Retry-After after 429. Inspect safeToRetry after 500 or 503. If a connection drops after submission, poll the existing action. Never create a replacement action from network uncertainty. Preserve the original action after 409. Store X membership rejections after 422. Wait for Retry-After after 429. Store the action ID and final membership result. Never infer posting permission from membership.

Headers

string

required

Your API key. OAuth bearer authentication is also supported. Generate a key from the dashboard.

string

required

Unique key for this intended write. Reuse it only when every request field remains unchanged.

string

required

Must be application/json.

Path parameters

string

required

The ID of the community to join.

Body

string

required

The connected X account to join the community with. Must be a username you have connected to your Xquik account.

Response

404 Account not found

Connect the requested account, then submit a newly approved write.

Durable write recovery

Send one unique Idempotency-Key per intended write. Reuse it only for the same account, target, payload, and media.

Store id, the nested hash in request, billing, and statusUrl.
Poll after Retry-After or pollAfterMs when terminal is false.
Trust safeToRetry and nextAction before any new write.

200 Terminal or 202 active

Store terminal results. Poll active actions without creating another write.

After HTTP 200, store the result and settled billing.
After HTTP 202, poll the same action. Never submit another write.
After HTTP 400, fix the named field. Use a new idempotency key.
After HTTP 401, fix authentication. Do not retry unchanged.
After HTTP 402, fund the account before another write.
After HTTP 403, reconnect the account.
After HTTP 409, keep the original action. Use a new key for new input.
After HTTP 422, fix the rejected request before retrying.
After HTTP 429, wait for Retry-After. Preserve the same key.
After HTTP 500, retry only when safeToRetry is true.
After HTTP 503, poll while terminal is false.

See Get Write Action Status for every lifecycle field, terminal state, billing field, and retry rule.

{
  "object": "x_write_action",
  "id": "12345",
  "writeActionId": "12345",
  "action": "join_community",
  "status": "success",
  "terminal": true,
  "retryable": false,
  "safeToRetry": false,
  "statusUrl": "/api/v1/x/write-actions/12345",
  "pollAfterMs": null
}

{
  "object": "x_write_action",
  "id": "12346",
  "writeActionId": "12346",
  "action": "join_community",
  "status": "dispatching",
  "terminal": false,
  "retryable": false,
  "safeToRetry": false,
  "statusUrl": "/api/v1/x/write-actions/12346",
  "pollAfterMs": 2000
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check request fields.",
  "charged": false,
  "chargedCredits": "0",
  "retryable": false,
  "safeToRetry": true
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "account_needs_reauth",
  "message": "X account needs re-authentication. Re-add the account."
}

{
  "error": "account_not_found",
  "message": "X account not found. Connect it first at /dashboard/account?tab=x-accounts."
}

{
  "error": "idempotency_conflict",
  "message": "Idempotency-Key was already used with a different request.",
  "charged": false,
  "chargedCredits": "0",
  "retryable": false,
  "safeToRetry": true
}

{
  "error": "x_rejected",
  "message": "X rejected this request. Wait a few minutes and try again."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_write_failed",
  "message": "Write action failed unexpectedly. Contact support if this persists."
}

{
  "error": "write_tracking_unavailable",
  "message": "Write tracking unavailable. Try again.",
  "charged": false,
  "chargedCredits": "0",
  "retryable": true,
  "safeToRetry": true
}

How to join a community on Twitter via API

curl --request POST \
  --url https://xquik.com/api/v1/x/communities/{id}/join \
  --header 'Content-Type: <content-type>' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "account": "<string>"
}
'

import requests

url = "https://xquik.com/api/v1/x/communities/{id}/join"

payload = { "account": "<string>" }
headers = {
    "x-api-key": "<api-key>",
    "Idempotency-Key": "<idempotency-key>",
    "Content-Type": "<content-type>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-api-key': '<api-key>',
    'Idempotency-Key': '<idempotency-key>',
    'Content-Type': '<content-type>'
  },
  body: JSON.stringify({account: '<string>'})
};

fetch('https://xquik.com/api/v1/x/communities/{id}/join', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/communities/{id}/join"

	payload := strings.NewReader("{\n  \"account\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

​How to join a community on Twitter through the API

​Understand open, restricted, and invited membership

​Find Twitter communities before joining

​Compare manual and API community joining

​Review account eligibility and moderator limits

​Choose the correct X relationship

​Plan post-join reading and publishing

​Resolve membership intent

​How to join Twitter community membership safely

​Join communities in controlled batches

​Verify visible membership

​Explain community post visibility

​Answer common Twitter community questions

​How to join a Twitter community with Xquik?

​Can I join an invitation-only Twitter community?

​What happens when you join a Twitter community?

​Can people see the communities you join on Twitter?

​How do I join a community on a phone?

​Do Twitter communities still exist?

​Do I need X Premium to join a community?

​Why can’t I join a Twitter community?

​How do I find active Twitter communities by interest?

​What are the benefits of joining a Twitter community?

​How should a brand participate after joining?

​Is community notes the same as X communities?

​Can this API create, moderate, or grow a community?

​Recover from join failures

​Headers

​Path parameters

​Body

​Response

​Durable write recovery

​200 Terminal or 202 active

How to join a community on Twitter through the API

Understand open, restricted, and invited membership

Find Twitter communities before joining

Compare manual and API community joining

Review account eligibility and moderator limits

Choose the correct X relationship

Plan post-join reading and publishing

Resolve membership intent

How to join Twitter community membership safely

Join communities in controlled batches

Verify visible membership

Explain community post visibility

Answer common Twitter community questions

How to join a Twitter community with Xquik?

Can I join an invitation-only Twitter community?

What happens when you join a Twitter community?

Can people see the communities you join on Twitter?

How do I join a community on a phone?

Do Twitter communities still exist?

Do I need X Premium to join a community?

Why can’t I join a Twitter community?

How do I find active Twitter communities by interest?

What are the benefits of joining a Twitter community?

How should a brand participate after joining?

Is community notes the same as X communities?

Can this API create, moderate, or grow a community?

Recover from join failures

Headers

Path parameters

Body

Response

Durable write recovery

200 Terminal or 202 active