API Guide

Authorization: Bearer aa_sk_your_api_key_here

curl -H "Authorization: Bearer aa_sk_..." \
  https://authorautomations.social/api/v1/accounts

curl -X POST \
  -H "Authorization: Bearer aa_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from the API!",
    "accountIds": ["682..."],
    "publishNow": true
  }' \
  https://authorautomations.social/api/v1/posts

{
  "accounts": [
    {
      "_id": "682a1b2c3d4e5f6a7b8c9d0e",
      "platform": "instagram",
      "username": "mybookaccount",
      "displayName": "My Book Account",
      "profileUrl": "https://instagram.com/mybookaccount",
      "isActive": true
    }
  ],
  "hasAnalyticsAccess": false
}

{
  "content": "Check out my new book!",
  "accountIds": ["682a1b2c3d4e5f6a7b8c9d0e"],
  "publishNow": true
}

{
  "content": "Coming soon!",
  "accountIds": ["682a1b2c3d4e5f6a7b8c9d0e"],
  "publishNow": false,
  "scheduledAt": "2026-03-20T14:00:00Z",
  "timezone": "America/Chicago"
}

{
  "content": "New book trailer!",
  "accountIds": ["tiktok_account_id"],
  "publishNow": true
}

{
  "content": "New book trailer!",
  "accountIds": ["tiktok_account_id"],
  "publishNow": true,
  "tiktokOptions": {
    "draft": true,
    "privacyLevel": "PUBLIC_TO_EVERYONE",
    "allowComment": true
  }
}

{
  "content": "Sneak peek for friends only",
  "accountIds": ["tiktok_account_id"],
  "publishNow": true,
  "tiktokOptions": {
    "privacyLevel": "MUTUAL_FOLLOW_FRIENDS",
    "allowDuet": false,
    "allowStitch": false
  }
}

{
  "exists": true,
  "schedule": {
    "_id": "queue_abc123",
    "name": "Default Queue",
    "timezone": "America/Chicago",
    "active": true,
    "isDefault": true,
    "slots": [
      { "dayOfWeek": 1, "time": "09:00" },
      { "dayOfWeek": 1, "time": "14:00" },
      { "dayOfWeek": 3, "time": "09:00" },
      { "dayOfWeek": 5, "time": "11:00" }
    ]
  },
  "nextSlots": [
    "2026-03-17T09:00:00-05:00",
    "2026-03-17T14:00:00-05:00",
    "2026-03-19T09:00:00-05:00"
  ]
}

{
  "queues": [
    {
      "_id": "queue_abc123",
      "name": "Morning Posts",
      "active": true,
      "isDefault": true,
      "slots": [...]
    },
    {
      "_id": "queue_def456",
      "name": "Evening Content",
      "active": true,
      "isDefault": false,
      "slots": [...]
    }
  ],
  "count": 2
}

{
  "profileId": "69821296e40fdedc04fa993f",
  "count": 5,
  "slots": [
    "2026-03-17T09:00:00-05:00",
    "2026-03-17T14:00:00-05:00",
    "2026-03-19T09:00:00-05:00",
    "2026-03-21T11:00:00-05:00",
    "2026-03-24T09:00:00-05:00"
  ]
}

{
  "filename": "book-cover.jpg",
  "contentType": "image/jpeg",
  "size": 245000
}

{
  "uploadUrl": "https://storage.example.com/presigned-put-url...",
  "publicUrl": "https://cdn.example.com/media/book-cover.jpg",
  "key": "media/abc123/book-cover.jpg",
  "type": "image"
}

curl -X PUT \
  -H "Content-Type: image/jpeg" \
  --data-binary @book-cover.jpg \
  "https://storage.example.com/presigned-put-url..."

curl -X POST \
  -H "Authorization: Bearer aa_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "My new book is here!",
    "accountIds": ["682a1b2c3d4e5f6a7b8c9d0e"],
    "publishNow": true,
    "mediaItems": [
      {
        "type": "image",
        "url": "https://cdn.example.com/media/book-cover.jpg"
      }
    ]
  }' \
  https://authorautomations.social/api/v1/posts

# 1. Get your accounts
ACCOUNTS=$(curl -s -H "Authorization: Bearer $API_KEY" \
  https://authorautomations.social/api/v1/accounts)

ACCOUNT_ID=$(echo $ACCOUNTS | jq -r '.accounts[0]._id')

# 2. Get a presigned upload URL
PRESIGN=$(curl -s -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename":"promo.jpg","contentType":"image/jpeg"}' \
  https://authorautomations.social/api/v1/media/presign)

UPLOAD_URL=$(echo $PRESIGN | jq -r '.uploadUrl')
PUBLIC_URL=$(echo $PRESIGN | jq -r '.publicUrl')

# 3. Upload the file
curl -X PUT -H "Content-Type: image/jpeg" \
  --data-binary @promo.jpg "$UPLOAD_URL"

# 4. Check queue for next available time
curl -s -H "Authorization: Bearer $API_KEY" \
  https://authorautomations.social/api/v1/queue/preview?count=3

# 5. Create the post with the uploaded image
curl -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"content\": \"New release day! Grab your copy now.\",
    \"accountIds\": [\"$ACCOUNT_ID\"],
    \"scheduledAt\": \"2026-03-20T14:00:00Z\",
    \"publishNow\": false,
    \"mediaItems\": [{\"type\": \"image\", \"url\": \"$PUBLIC_URL\"}]
  }" \
  https://authorautomations.social/api/v1/posts

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description",
    "requestId": "req_abc123"
  }
}

claude plugin install author-automations-social

/author-automations-social:aa-setup

/author-automations-social:aa-post My new book is available for pre-order!

"Create an Instagram and TikTok post about my book launch"

/author-automations-social:aa-campaign 14-day campaign for my spring book launch

"Create a 30-day social media campaign to promote Curses and Currents across Instagram, TikTok, and Facebook"