/v1/communities/{community_id}/actors/{actor_id}/hashtag-followsAuthFollow a hashtag on behalf of an actor. Idempotent — re-follow refreshes the followed_at timestamp but doesn't error.
Path parameters
community_id*stringSocial community UUID. Must belong to the PAK's workspace.
actor_id*stringSocial actor UUID who is following.
Headers
Idempotency-KeystringOpaque 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*stringLowercase tag (without `#`). Must already exist in the community directory.
Example: "storymode"
Response · 201 Follow created (or refreshed).
actor_id*string · uuidSocial actor UUID.
Example: "aaaaaaaa-0000-0000-0000-000000000001"
community_id*string · uuidOwning community UUID.
Example: "cccccccc-cccc-cccc-cccc-cccccccccccc"
tag*stringLowercase tag (without `#`).
Example: "storymode"
followed_at*string · date-timeISO 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"
}