SECTION 2 — CREATOR SOCIAL

9. POST /creators/:id/follow

Follow a creator. Requires authentication.

Request

POST /creators/creator_001/follow
Authorization: Bearer <token>

Response 200 OK

{
  "status": "success",
  "message": "You are now following Chris Spencer",
  "data": {
    "creator_id": "creator_001",
    "is_following": true,
    "followers_count": 124001,
    "followers_count_formatted": "124K"
  }
}

Errors

{
  "status": "error",
  "code": 409,
  "message": "You are already following this creator"
}

10. DELETE /creators/:id/follow

Unfollow a creator. Requires authentication.

Request

DELETE /creators/creator_001/follow
Authorization: Bearer <token>

Response 200 OK

{
  "status": "success",
  "message": "You have unfollowed Chris Spencer",
  "data": {
    "creator_id": "creator_001",
    "is_following": false,
    "followers_count": 124000,
    "followers_count_formatted": "124K"
  }
}

11. POST /creators/:id/tip

Send a monetary tip to a creator. Requires authentication.

Request

POST /creators/creator_001/tip
Authorization: Bearer <token>
Content-Type: application/json

Request Body

{
  "amount": 5.00,
  "currency": "USD",
  "message": "Great show, keep it up!",
  "payment_method_id": "pm_abc123"
}

Request Body Parameters

Field	Type	Required	Description
amount	float	Yes	Tip amount
currency	string	Yes	Currency code e.g. USD
message	string	No	Optional message to creator
payment_method_id	string	Yes	Payment method on file

Response 200 OK

{
  "status": "success",
  "message": "Tip sent successfully to Chris Spencer",
  "data": {
    "tip_id": "tip_xyz789",
    "creator_id": "creator_001",
    "amount": 5.00,
    "currency": "USD",
    "message": "Great show, keep it up!",
    "sent_at": "2024-11-01T12:00:00Z"
  }
}

Errors

{
  "status": "error",
  "code": 400,
  "message": "Tip amount must be at least $1.00"
}

{
  "status": "error",
  "code": 402,
  "message": "Payment failed. Please check your payment method."
}