Social API reference

Social API · Hashtag-Follows

post/v1/communities/{community_id}/actors/{actor_id}/hashtag-followsAuth

Follow a hashtag on behalf of an actor. Idempotent — re-follow refreshes the followed_at timestamp but doesn't error.

Path parameters

community_id*string

Social community UUID. Must belong to the PAK's workspace.

actor_id*string

Social actor UUID who is following.

Headers

Idempotency-Keystring

Opaque client-generated string (1-256 chars, `[A-Za-z0-9._:-]`) that makes a retry safe: within 24 h a repeat with the same key and body returns the original response with `Idempotent-Replay: true` instead of running again. Same key with a different body is `409 IDEMPOTENCY_KEY_REUSE`.

Request body

tag*string

Lowercase tag (without `#`). Must already exist in the community directory.

Example: "storymode"

Response · 201 Follow created (or refreshed).

actor_id*string · uuid

Social actor UUID.

Example: "aaaaaaaa-0000-0000-0000-000000000001"

community_id*string · uuid

Owning community UUID.

Example: "cccccccc-cccc-cccc-cccc-cccccccccccc"

tag*string

Lowercase tag (without `#`).

Example: "storymode"

followed_at*string · date-time

ISO timestamp the follow was created.

Example: "2026-05-01T12:00:00.000Z"

Example

Request

POST https://social.productcraft.co/v1/communities/{community_id}/actors/{actor_id}/hashtag-follows
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "tag": "storymode"
}

Response

{
  "actor_id": "aaaaaaaa-0000-0000-0000-000000000001",
  "community_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
  "tag": "storymode",
  "followed_at": "2026-05-01T12:00:00.000Z"
}