Skip to main content
POST
/
api
/
v1
/
tracked-accounts
Add Tracked Account
curl --request POST \
  --url https://www.catchthegoodones.com/api/v1/tracked-accounts
{
  "account": {
    "id": 2,
    "xHandle": "elonmusk",
    "xUserId": "44196397",
    "tier": "top",
    "isActive": true,
    "profileImageUrl": "https://pbs.twimg.com/profile_images/example.jpg",
    "lastKnownFollowerCount": 180000000
  },
  "isFirstAccount": false
}
Adds a new X handle to track. The profile is resolved and validated, and a Stripe subscription item is added for the selected tier. Billing note: This endpoint increments your Stripe subscription quantity for the chosen tier if no unused slots are available. You will be charged pro-rata for the remainder of the billing period.

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer ctgo_your_api_key_here
Content-TypeYesapplication/json

​
Body

FieldTypeRequiredDescription
handlestringYesX handle to track (with or without @)
tierstringYes"starter", "growth", or "pro"

​
Example

curl -X POST https://www.catchthegoodones.com/api/v1/tracked-accounts \
  -H "Authorization: Bearer ctgo_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"handle": "elonmusk", "tier": "pro"}'

​
Response

{
  "account": {
    "id": 2,
    "xHandle": "elonmusk",
    "xUserId": "44196397",
    "tier": "top",
    "isActive": true,
    "profileImageUrl": "https://pbs.twimg.com/profile_images/example.jpg",
    "lastKnownFollowerCount": 180000000
  },
  "isFirstAccount": false
}