How do I send handwritten cards from my CRM?

#The three pieces, and which one you need

#The pattern that works, in order

1. Decide what the trigger is, precisely

   Deal moves to closed-won is a trigger. Deal updated is not — it will fire on every note, and every fire is a card and a credit.

2. Confirm the CRM record actually carries a postal address

   This is where most integrations fail. Sales CRMs are full of contacts with an email, a phone number and no street. Check the field coverage before you build anything.

   You’ll know it worked when You can name the CRM fields that map to line1, city, state and zip for the majority of the records you intend to trigger on.

3. Start with an inbound hook, not the API

   Even if you intend to write code, a hook proves the whole path in ten minutes: create it under Integrations, curl it once, and see a card appear.

   curl -X POST https://scribblecards.com/api/v1/hooks/whk_YOURTOKEN \
     -H "Content-Type: application/json" \
     -d '{
       "name": "Dana Okafor",
       "line1": "88 Colin P Kelly Jr St",
       "city": "San Francisco",
       "state": "CA",
       "zip": "94107",
       "message": "Thanks for four great years, Dana."
     }'

   You’ll know it worked when A 201 with a card code, and the card visible under Sent cards.

4. Move to the API when you need control

   Use POST /api/v1/cards when you need to choose the design per card, set an arrive_on date, or read the status back later. Create a key under Integrations with only the scopes you need.

5. Decide how you learn a card was mailed

   You can register a webhook endpoint under Integrations → Webhooks and verify the signature on every delivery. Today only card.created and card.held actually fire, and only for cards sent through the API or a hook.

   So for a card mailed entry on a CRM timeline, poll GET /api/v1/cards/{card_code} for the cards you are tracking and watch mailed_at.

   You’ll know it worked when The delivery log on the Integrations screen shows HTTP 200 against your endpoint for a test delivery.

6. Sync the address book, if you need lists

   If you want to run automations off CRM data — birthdays, renewal dates — push contacts in with POST /api/v1/contacts and always send an external_id. See keeping contacts in sync for the pitfall.