For developers and tinkerers

Start a card from wherever you already work

Two little endpoints, one big shortcut. Zapier, Make, a Slack command, a spreadsheet macro: if it can send a POST request, it can start a Pass It Round card and drop notes on the wall. Cards made this way behave exactly like cards made on the site: free to make and sign, one small payment when the organizer is ready to send.

Getting a key

Every request needs an integration key. Ask for one in the chat (bottom right of any page) and the team will mint one for you. Send it as a bearer token:

Authorization: Bearer pir_your_key_here

Keep it secret. We only store a scrambled copy, so if you lose it we make you a fresh one rather than look it up.

Start a card

POST /api/public/create-card

{
  "recipientName": "Sarah",
  "occasion": "leaving",
  "organizerName": "Tom",
  "headline": "Good luck, Sarah!",        // optional, we write one if you skip it
  "notes": [                              // optional, up to 50
    { "author": "Priya", "body": "You will be missed!", "colour": "mint" }
  ]
}

You get back the signing link to share with everyone and the private organizer link. Whoever triggered the automation should get the organizer link: that is where they pay the one-off unlock and send the card when it is full of notes.

{
  "slug": "abc123xy",
  "signingUrl": "https://passitround.com/c/abc123xy",
  "manageUrl": "https://passitround.com/c/abc123xy/manage?t=...",
  "notesAdded": 1
}

Occasions: leaving, birthday, new_baby, get_well, wedding, retirement, congratulations, thank_you, just_because. Note colours: lemon, mint, sky, peach, rose, cream.

Add a note to an open card

Handy for one-response-per-note automations, like each Google Form answer becoming a sticky note. Notes can only land while the card is still open for signing.

POST /api/public/add-note

{
  "slug": "abc123xy",
  "author": "Priya",
  "body": "Best of luck in the new job!",
  "colour": "mint"    // optional
}

Zapier and Make, the short version

Add a Webhooks (Zapier) or HTTP (Make) action to your workflow.
Point it at https://passitround.com/api/public/create-card with method POST and a JSON body.
Add the Authorization header with your key.
Map your form or spreadsheet fields onto recipientName, occasion and notes.
Send the manageUrl from the response back to the organizer so they can pay and send.

Stuck? Ask in the chat. Rosie knows the API and can talk you through the wiring.