/v1/communities/{community_id}/listsAuthCreate a new list. Default visibility `private`. List creation has no natural key (an owner can hold many same-named lists), so pass an `Idempotency-Key` header to make retries safe.
Path parameters
community_id*stringSocial community UUID.
Headers
Idempotency-KeystringOpaque client-generated string (1–256 chars, `[A-Za-z0-9._:-]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`.
Request body
actor_idstring · uuidThe acting actor, who owns the new list. Send it, or the deprecated `owner_id`; one of the two is required.
Example: "aaaaaaaa-0000-0000-0000-000000000001"
owner_idstring · uuidDeprecated alias of `actor_id`; send `actor_id`.
Example: "aaaaaaaa-0000-0000-0000-000000000001"
name*stringDisplay name (1..200).
Example: "Tech news"
descriptionstringOptional description (0..2000).
visibilityenum (2)Default `private`.
Example: "public"
Response · 201 List created.
id*string · uuidList UUID.
Example: "11111111-0000-0000-0000-000000000001"
community_id*string · uuidOwning community UUID.
Example: "cccccccc-cccc-cccc-cccc-cccccccccccc"
owner_id*string · uuidList owner — social actor UUID.
Example: "aaaaaaaa-0000-0000-0000-000000000001"
name*stringList display name.
Example: "Tech news"
description*stringOptional description.
Example: "Curated tech accounts I follow."
visibility*objectpublic = discoverable; private = owner-only.
Example: "public"
member_count*numberCurrent member count.
Example: 12
created_at*string · date-timeISO timestamp.
Example: "2026-05-01T12:00:00.000Z"
updated_at*string · date-timeISO timestamp.
Example: "2026-05-01T12:00:00.000Z"
Example
Request
POST https://social.productcraft.co/v1/communities/{community_id}/lists
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
{
"actor_id": "aaaaaaaa-0000-0000-0000-000000000001",
"owner_id": "aaaaaaaa-0000-0000-0000-000000000001",
"name": "Tech news",
"description": "string",
"visibility": "public"
}Response
{
"id": "11111111-0000-0000-0000-000000000001",
"community_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
"owner_id": "aaaaaaaa-0000-0000-0000-000000000001",
"name": "Tech news",
"description": "Curated tech accounts I follow.",
"visibility": "public",
"member_count": 12,
"created_at": "2026-05-01T12:00:00.000Z",
"updated_at": "2026-05-01T12:00:00.000Z"
}