Create a Twitter Community with the X Community API

{
  "object": "x_write_action",
  "id": "12345",
  "writeActionId": "12345",
  "action": "create_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": "create_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

Create a Twitter Community with the X Community API

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

import requests

url = "https://xquik.com/api/v1/x/communities"

payload = {
    "account": "<string>",
    "name": "<string>",
    "description": "<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>', name: '<string>', description: '<string>'})
};

fetch('https://xquik.com/api/v1/x/communities', 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"

	payload := strings.NewReader("{\n  \"account\": \"<string>\",\n  \"name\": \"<string>\",\n  \"description\": \"<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 Create a Community on Twitter with Xquik

Call POST /x/communities to create a community on Twitter from one connected account. This create Twitter community workflow submits a name and optional description. Xquik then tracks the write until X returns a final result. Use this route only when the account should own a new community. Use join or leave routes for an existing community. This route does not add rules, members, moderators, invitations, posts, analytics, or membership settings. Each community gives one topic a dedicated space on X. People can search for communities by name, description, or creator. They can join a community later. Each member of the community follows the chosen membership type and community rules. This X social media workflow creates the community container only.

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

curl -X POST https://xquik.com/api/v1/x/communities \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Idempotency-Key: community-create-1895432178065391234" \
  -H "Content-Type: application/json" \
  -d '{
    "account": "myxhandle",
    "name": "Crypto Traders Hub",
    "description": "A community for crypto traders to share insights and strategies."
  }' | jq

const response = await fetch("https://xquik.com/api/v1/x/communities", {
  method: "POST",
  headers: {
    "x-api-key": "xq_YOUR_KEY_HERE",
    "Idempotency-Key": "community-create-1895432178065391234",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    account: "myxhandle",
    name: "Crypto Traders Hub",
    description: "A community for crypto traders to share insights and strategies.",
  }),
});
const data = await response.json();

import requests

response = requests.post(
    "https://xquik.com/api/v1/x/communities",
    headers={
        "x-api-key": "xq_YOUR_KEY_HERE",
        "Idempotency-Key": "community-create-1895432178065391234",
    },
    json={
        "account": "myxhandle",
        "name": "Crypto Traders Hub",
        "description": "A community for crypto traders to share insights and strategies.",
    },
)
data = response.json()

package main

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

func main() {
    body, _ := json.Marshal(map[string]interface{}{
        "account":     "myxhandle",
        "name":        "Crypto Traders Hub",
        "description": "A community for crypto traders to share insights and strategies.",
    })

    req, err := http.NewRequest("POST", "https://xquik.com/api/v1/x/communities", bytes.NewReader(body))
    if err != nil {
        panic(err)
    }
    req.Header.Set("x-api-key", "xq_YOUR_KEY_HERE")
    req.Header.Set("Idempotency-Key", "community-create-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)
}

Prepare a Community Creation Request

Approve the community name, description, and rules before this call. Keep the connected owner in the approval record. Create one idempotency key for the intended community. Reuse it only when the same request needs network recovery. Use a new key after any approved input changes. Community creation workflows should include:

Checking the final name for spelling and scope.
Reviewing rules with the future moderation team.
Recording the owner account and approval reference.
Saving the returned community and action identifiers.

Do not submit parallel requests with different keys for one intended community. That can create multiple communities. Read the lifecycle state before exposing the new community to downstream workflows.

Build a Reviewable Community Brief

Create a short brief before calling this endpoint. Record the proposed name, description, owner account, audience, and moderation purpose. Keep that brief beside the approval record. Reviewers can then compare the submitted fields against the approved community identity. Treat the name as a lasting public label. Check spelling, capitalization, and topic scope before approval. Use the description to explain who should join. Avoid campaign dates or temporary slogans in either field. Those details age quickly and make later community discovery confusing. Choose one connected account as the accountable owner. Record its username and stable account ID when available. Confirm that the account appears in your connected-account inventory. Keep the same owner during network recovery. A different owner means a different write request. Store these creation inputs together:

Connected owner username and account ID.
Final community name and description.
Approval reference and approving operator.
Idempotency key for this exact submission.
Returned action ID and lifecycle state.

This record separates approval from network recovery. Repeat the unchanged request only after a network timeout. Changed text needs a new approval and key.

Confirm the Community Admin Account

Choose the connected account before review. X assigns admin ownership to the original creator. Community admins manage names, descriptions, rules, and moderators in X. Xquik only sends the creation request. X currently requires an eligible admin account. Its official moderator playbook lists these checks:

Use a public account.
Use an account that is at least 6 months old.
Verify an email address or phone number.
Keep the account compliant with the X Terms of Service.

X enforces these requirements and can change them. The request has no eligibility override. It also has no Premium field. Confirm current eligibility inside X before approval. Preserve any rejection reason for the operator. Review the X Communities moderator playbook before assigning the owner. It explains creator, admin, moderator, and member responsibilities. Store the chosen account with the approved community brief.

Plan Community Rules and Membership

Define community rules before creating the container. Rules should describe the topic, allowed behavior, and moderation response. Do not place temporary campaign instructions in the public description. Keep the full rule set in the team’s approved moderation record. X offers open communities and restricted membership. Open communities show a Join button at the top of the community page. Restricted communities can let a person request to join. A moderator then accepts or denies that request. X may also allow member invitations. This endpoint does not choose a membership type. It does not add community members or moderators. Configure those settings after creation through the current X interface. Record the selected mode beside the returned community ID. Read the X Communities guide before opening membership. It covers visibility, roles, invitations, and moderation. Use the guide as the source for current X behavior. Use this page for Xquik’s API contract.

Prepare a Brand or Product Community

Use a specific name that explains the shared topic. Write a description that identifies the intended community members. State who operates the community. Avoid names that imply an unsupported partnership or endorsement. Prepare the first discussion topics before launch. Assign community admins and moderators before invitations begin. Decide who reviews reports and removes disruptive members. Keep escalation rules outside the public description. This route cannot publish welcome posts or schedule discussions. It cannot promote or monetize the community. After launch, publish Community posts with Create Tweet. X may display Community posts inside a member’s Twitter feed.

Connect the Community to a Website or App

The request has no website, app, rules, or invitation field. Store those links in your application after X confirms creation. Associate them with the returned community ID, owner account, approval, and lifecycle record. After success, verify the name on the community page. Search for communities by name, description, or creator through X when available. X notes that not every community appears in search results. Do not treat search visibility as proof of creation. Use the community ID as the stable integration key. Do not key integrations by the editable display name. Store a verified community URL only after the read route confirms the new ID.

Answer Common Community Creation Questions

Do X Communities Still Exist?

Yes. X still publishes current Communities and moderator guidance. This API creates an X Community through a connected account. X controls feature availability and account eligibility.

Do You Need X Premium to Create a Community?

The Xquik request does not accept a Premium setting. X decides whether the connected account can create the community. Check current X eligibility before submitting a billable write.

Can the API Add Rules, Members, or Moderators?

No. The canonical request accepts account, name, and description. Set community rules, membership type, invitations, and moderator roles after creation. Never send undocumented fields.

Can the API Schedule, Grow, or Monetize a Community?

No. This route creates the community and tracks that write. It does not schedule posts, invite initial members, run promotions, provide analytics, or configure monetization.

How Should Software Handle Community Creation?

Require an approved brief and one idempotency key. Store the action ID immediately. Poll the lifecycle, verify the new community ID, and then start separate membership or publishing workflows.

Validate the New Community

Wait for the write lifecycle to finish before announcing the community. A 202 response means Xquik accepted the write for processing. It does not prove that X completed community creation. Follow the returned lifecycle state until the action reaches its final result. Capture the new community ID from the confirmed result. Then call Community Info. Compare its name and description with the approved brief. Save the returned community ID beside the owner account and action ID. Run these checks before inviting members:

Confirm the community ID resolves.
Compare the returned name with the approved name.
Compare the returned description with the approved description.
Confirm the intended owner account remains connected.
Record the final write state and verification time.

Repeat the information request after a temporary read failure. Keep the same key only when every input remains unchanged.

Handle Creation Failures Safely

Treat each response by its actual cause. Fix invalid names or missing accounts before sending another write. Restore credits before retrying a 402 response. Reconnect the owner after 403. A 409 means the key already identifies another request. Compare both request bodies. Reuse the key only when every creation input matches. Generate a new key after any approved field changes. For 422, preserve the rejected request and returned reason. Do not rewrite the community brief automatically. Return it to the operator for review. For 429, respect the retry guidance and keep the same approved intent. After 503, check the write lifecycle before retrying. A disconnected client does not prove failure. Duplicate creation costs more than delayed verification.

Community creation record	Request or response source	Completion rule
Owner	Request `account`	Match the connected owner.
Name	Request `name`	Keep the approved name.
Purpose	Request `description`	Keep the approved description.
Replay key	Request header	Reuse it for one exact replay.
Action ID	Response `id`	Poll this lifecycle record.
State	Response `status` and `terminal`	Stop after a terminal result.
Community ID	Response `communityId`	Store it after success.
Verification	`GET /x/communities/{id}/info`	Match the name and owner.

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 for an exact network replay.

string

required

Must be application/json.

Body

string

required

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

string

required

The name for the new community.

string

Optional description for the community explaining its purpose.

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": "create_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": "create_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
}

Create a Twitter Community with the X Community API

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

import requests

url = "https://xquik.com/api/v1/x/communities"

payload = {
    "account": "<string>",
    "name": "<string>",
    "description": "<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>', name: '<string>', description: '<string>'})
};

fetch('https://xquik.com/api/v1/x/communities', 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"

	payload := strings.NewReader("{\n  \"account\": \"<string>\",\n  \"name\": \"<string>\",\n  \"description\": \"<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))

}

Overview

X API

X Write

Trends

Radar

Account

API Keys

Guest Wallets

Credits

X Accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Create a Twitter Community with the X Community API

How to Create a Community on Twitter with Xquik

Prepare a Community Creation Request

Build a Reviewable Community Brief

Confirm the Community Admin Account

Plan Community Rules and Membership

Prepare a Brand or Product Community

Connect the Community to a Website or App

Answer Common Community Creation Questions

Do X Communities Still Exist?

Do You Need X Premium to Create a Community?

Can the API Add Rules, Members, or Moderators?

Can the API Schedule, Grow, or Monetize a Community?

How Should Software Handle Community Creation?

Validate the New Community

Handle Creation Failures Safely

Headers

Body

Response

Durable Write Recovery

200 Terminal or 202 Active

​How to Create a Community on Twitter with Xquik

​Prepare a Community Creation Request

​Build a Reviewable Community Brief

​Confirm the Community Admin Account

​Plan Community Rules and Membership

​Prepare a Brand or Product Community

​Connect the Community to a Website or App

​Answer Common Community Creation Questions

​Do X Communities Still Exist?

​Do You Need X Premium to Create a Community?

​Can the API Add Rules, Members, or Moderators?

​Can the API Schedule, Grow, or Monetize a Community?

​How Should Software Handle Community Creation?

​Validate the New Community

​Handle Creation Failures Safely

​Headers

​Body

​Response

​Durable Write Recovery

​200 Terminal or 202 Active

How to Create a Community on Twitter with Xquik

Prepare a Community Creation Request

Build a Reviewable Community Brief

Confirm the Community Admin Account

Plan Community Rules and Membership

Prepare a Brand or Product Community

Connect the Community to a Website or App

Answer Common Community Creation Questions

Do X Communities Still Exist?

Do You Need X Premium to Create a Community?

Can the API Add Rules, Members, or Moderators?

Can the API Schedule, Grow, or Monetize a Community?

How Should Software Handle Community Creation?

Validate the New Community

Handle Creation Failures Safely

Headers

Body

Response

Durable Write Recovery

200 Terminal or 202 Active