Skip to main content
POST
/
community
Create Community
curl --request POST \
  --url https://api.dontdie.com/community \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-dd-client-id: <api-key>' \
  --data '
{
  "ownerId": "<string>",
  "communityName": "<string>",
  "communityDesc": "<string>",
  "state": "<string>",
  "country": "<string>",
  "isPrivate": true,
  "bannerImageUrl": "<string>",
  "imageUrl": "<string>",
  "timezone": "<string>",
  "city": "<string>",
  "isVerified": true,
  "isFeatured": true
}
'
{
  "id": "1234-5678-9012-3456",
  "ownerId": "1234-5678-9012-3456",
  "timezone": "America/New_York",
  "communityName": "My Community",
  "conversationId": "1234-5678-9012-3456",
  "city": "New York",
  "isArchived": false,
  "createdAt": "2021-01-01T00:00:00Z",
  "createdBy": "1234-5678-9012-3456",
  "updatedAt": "2021-01-01T00:00:00Z",
  "updatedBy": "1234-5678-9012-3456"
}

Authorizations

​
Authorization
string
header
required

Enter your Bearer token in the format: Bearer

​
x-dd-client-id
string
header
required

Your API client ID for the request

Body

application/json
​
ownerId
string
required

The ID of the owner of the community

​
communityName
string
required

The name of the community

​
communityDesc
string
required

The description of the community

​
state
string
required

The state of the community

​
country
string
required

The country of the community

​
isPrivate
boolean
required

Whether the community is private

​
bannerImageUrl
string
required

The URL of the banner image for the community

​
imageUrl
string
required

The URL of the image for the community

​
timezone
string
required

The timezone of the community

​
city
string
required

The city of the community

​
isVerified
boolean

Whether the community is verified

​
isFeatured
boolean

Whether the community is featured

Response

200 - application/json

OK

​
id
string
required

The ID of the community

Example:

"1234-5678-9012-3456"

​
ownerId
string
required

The ID of the owner of the community

Example:

"1234-5678-9012-3456"

​
timezone
string
required

The timezone of the community

Example:

"America/New_York"

​
communityName
string
required

The name of the community

Example:

"My Community"

​
conversationId
string
required

The ID of the conversation for the community

Example:

"1234-5678-9012-3456"

​
city
string
required

The city of the community

Example:

"New York"

​
isArchived
boolean
required

Whether the community is archived

Example:

false

​
createdAt
string
required

The date and time the community was created

Example:

"2021-01-01T00:00:00Z"

​
createdBy
string
required

The ID of the user who created the community

Example:

"1234-5678-9012-3456"

​
updatedAt
string
required

The date and time the community was updated

Example:

"2021-01-01T00:00:00Z"

​
updatedBy
string
required

The ID of the user who updated the community

Example:

"1234-5678-9012-3456"