Build with Sided polls.

curl -X POST "https://api2.sided.co/auth/signin" \
  -H "Content-Type: application/json" \
  -d '{"field":"<service user email>","password":"<service user password>"}'

# → { "status": "success", "token": "eyJhbGci…" }   ← use as x-access-token below
# note the different host: sign-in lives on api2.sided.co, everything else on apiv7.sided.co

-H "x-access-token: <user JWT>" \
-H "x-network-domain: yournetwork.com" \
-H "Content-Type: application/json"

# 1
curl -X POST "https://apiv7.sided.co/api/master/uuid/issue" \
  -H "Content-Type: application/json" \
  -d '{"embedDomainId": 501, "clientId": 111}'

# 2  → { "data": { "uuidToken": "eyJhbGci…" } }
curl -X POST "https://apiv7.sided.co/api/master/uuid/xfer-token" \
  -H "Content-Type: application/json" \
  -d '{"embedDomainId": 501, "clientId": 111}'

-H "uuid-token: <uuidToken from step 2>"
# or as a query param:  ?clientUUIDToken=<uuidToken>

curl -G "https://apiv7.sided.co/api/admin/debates/generate-debates" \
  --data-urlencode "url=https://news.example.com/story" \
  --data-urlencode "clientId=12" --data-urlencode "count=3" \
  -H "x-access-token: <user JWT>" -H "x-network-domain: yournetwork.com"

curl -G "https://apiv7.sided.co/api/embed/feed" \
  --data-urlencode "clientId=111" \
  --data-urlencode "aiPollSourceUrl=https://news.example.com/story" \
  --data-urlencode "pageUrl=https://news.example.com/story" \
  --data-urlencode "embedPlacementId=340" \
  --data-urlencode "exclude=" --data-urlencode "categories=" \
  --data-urlencode "categoryNames=" --data-urlencode "uniqueUserId=0" \
  --data-urlencode "isQuestion=0" \
  -H "uuid-token: <uuidToken>"

{
  "status": 1,
  "data": [
    { "contentType": "Poll", "contentTypeId": 446345,
      "campaignId": null, "campaignName": null,
      "askId": null, "askName": null, "isSponsored": 0 },
    { "contentType": "Poll", "contentTypeId": 446300, /* … */ }
  ]
}

curl "https://apiv7.sided.co/api/debates/446181" \
  -H "uuid-token: <uuidToken>"

{
  "status": 1,
  "data": {
    "id": 446181,
    "thesis": "Where do you do most of your grocery shopping?",
    "slug": "where-do-you-do-most-of-your-grocery-shopping",
    "clientId": 111,
    "votes": 327,
    "arguments": 1,
    "comments": 0,
    "articleSourceId": 121310,
    "startedAt": "2026-07-01T06:28:40.000Z",
    "endedAt": "2026-07-08T06:27:38.000Z",
    "isQuestion": 0, "isDraft": 0, "requireEmail": -1
    // + sides[] with per-option vote counts
  }
}

curl -X POST "https://apiv7.sided.co/api/poll-side-analytics/generate-summary" \
  -H "x-access-token: <user JWT>" -H "x-network-domain: yournetwork.com" \
  -H "Content-Type: application/json" \
  -d '{"content":"62% chose supermarkets, 24% discount grocers, 14% online","pollDescription":"Where do you do most of your grocery shopping?"}'

{
  "status": "success",
  "data": {
    "topic": "grocery shopping habits",
    "sentiment": "neutral",
    "summary": "Most readers shop at supermarkets, with discount grocers second"
  }
}

curl -G "https://apiv7.sided.co/api/admin/debates/generate-debates" \
  --data-urlencode "text=Ask readers whether the city should expand bike lanes" \
  --data-urlencode "clientId=12" --data-urlencode "count=1" \
  -H "x-access-token: <user JWT>" -H "x-network-domain: yournetwork.com"

curl -X POST "https://apiv7.sided.co/api/debates/create" \
  -H "x-access-token: <user JWT>" -H "x-network-domain: yournetwork.com" \
  -H "Content-Type: application/json" \
  -d '{
    "thesis": "Should the city expand bike lanes?",
    "sides": [{"text": "Yes, expand them"}, {"text": "No, leave as is"}],
    "startedAt": "2026-07-02", "formatType": 1, "clientId": 12
  }'

curl -X POST "https://apiv7.sided.co/api/campaigns" \
  -H "x-access-token: <user JWT>" -H "x-network-domain: yournetwork.com" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0, "title": "Bike lane pulse — July", "description": "Reader sentiment",
    "sequenceId": 812, "debateId": 0, "formId": 0,
    "responseCountTarget": 2000, "responseCount": 0,
    "startDate": "2026-07-05", "endDate": "2026-07-19",
    "runFor": "network", "forNetworks": ["12","34"], "forGroups": [],
    "slotNumber": 2, "isActive": 1, "isSponsored": 0
  }'

curl -X POST "https://apiv7.sided.co/api/sequences" \
  -H "x-access-token: <user JWT>" -H "x-network-domain: yournetwork.com" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0, "name": "Transit priorities", "clientId": 12,
    "type": "Survey", "questionOrder": "InOrder",
    "showCorrectAnswers": "Immediately", "questionTimer": 0,
    "numberOfQuestions": 3, "startedAt": "2026-07-05", "endedAt": "2026-07-19",
    "isDeployed": false, "deployedAt": "", "deployedBy": 0
  }'

curl -X POST "https://apiv7.sided.co/api/call-to-action" \
  -H "x-access-token: <user JWT>" -H "x-network-domain: yournetwork.com" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 0, "title": "See the full results",
    "buttonText": "Read more", "buttonLink": "https://news.example.com/results",
    "linkToNextStep": 0, "styleTitle": {}, "styleDescription": {}, "styleButton": {}
  }'