How do I set up automated birthday cards?

This is the guide for the person who has a spreadsheet of staff or clients, wants a real card to land on each of their birthdays, and does not want to think about it again. It takes about twenty minutes once. Nothing here needs a developer.

#Step by step

1. Get the birthdays into Scribble

   Go to Contacts → Import contacts. Drop your CSV in, or select the cells in Excel or Google Sheets — including the header row — copy, and paste them into the box.

   On the mapping screen, make sure one of your columns is mapped to Birthday. Scribble recognizes headers called birthday, birthdate, date of birth, dob, bday and born automatically; anything else you set by hand from the dropdown.

   Work through the Fix problems step. Rows without a complete address cannot ever be mailed, so deal with them here rather than discovering it in December.

   You’ll know it worked when The Contacts page shows a With a birthday count that matches the number of people you expect. If it says 0, the birthday column did not map — go back and set it manually.

2. Put those people on a list

   Go to Contacts → Lists and create a fixed list, for example Staff or Clients, and add the people this rule should watch.

   This step is optional — a rule with no list watches everyone in the address book — but it is worth doing. Lists change and the rule follows them: someone added to the list next March is watched from next March, with no edit to the rule.

   You’ll know it worked when The list shows a member count.

3. Create the design the cards will use

   Go to Designs → New design and either pick a birthday card from the full catalog or upload your own artwork. Name it something you will recognize next year, like Staff birthdays 2026.

   Skip this and the rule uses your organization's default card, which is fine to start with.

4. Create the automation

   Go to Automations → New automation. The whole rule is one screen, and none of it is a date calculation: who it watches, what it sends, what it may spend.

   Under What it watches, choose Birthday. Only contacts with a birthday on file can ever match; the screen tells you how many that is right now.

   Under Who it watches, choose the list you made, or leave it as everyone.

   You’ll know it worked when The screen says something like 3 contacts are eligible right now. If it says the list has nobody with a birthday on file, stop and fix the import — the rule would otherwise send nothing, forever, silently.

5. Write the message

   Type the message that gets written on the card. Merge fields go in with double braces:

   {{first_name}}, {{full_name}}, {{company}}, {{job_title}}, {{city}}, {{state}} and {{sender_name}} are always available. Any extra column from your spreadsheet becomes a field too, named after the column.

   Set Signed by to whatever {{sender_name}} should become — a person's name, or the company's.

   Under Handwriting, your house hand is already selected. Leave it there unless this rule should read differently from the rest of your cards — every sample is shown in the real letterforms the pen will draw, and the card below the picker rewrites itself in whichever one you choose.

   Happy birthday, {{first_name}}!
   
   Everyone here is glad you're on the team. Have a
   brilliant day — and take the afternoon if you can
   get away with it.
   
   {{sender_name}}

   You’ll know it worked when Every contact the rule watches has a value for every field you used. A contact with no {{company}} is skipped with a reason rather than sent a card with a hole in it.

6. Cap the annual spend

   Set Cap for the year to a number you are comfortable with. An evergreen rule against a growing list is an open-ended bill; with a cap the rule stops at that many cards and tells you, instead of quietly spending. The count resets on 1 January.

   A sensible cap is your headcount plus about 20%.

7. Run it once by hand before you trust it

   Save the rule, then use Run now on the automation. It reports exactly who it matched, who it would write to and who it skipped and why, without you having to wait for a birthday.

   Read the skip reasons. No credits left, On your do-not-mail list and the message needs {{company}}, which this contact has no value for are all things you would rather know now.

   You’ll know it worked when The run log lists the people you expected, with the occurrence date matching their birthday.

8. Switch it on

   Set the rule to on and save. Nothing sends the moment you save: the scheduler runs once a day, and the rule joins it from the next run.

   You’ll know it worked when The rule shows as active, and within a day or so you will see cards appearing under Sent cards tagged with the automation's name.

#When each card arrives

You never set a date on the rule, and there is no timing to get right. The birthday is the date the card should arrive by: Scribble works backwards from it and posts the card so it lands in a four to five day window ending on that date. We cannot promise an exact day, because once a card is with USPS the last mile is not ours to control, so we aim to be early rather than late.

The rule builder says this back to you as you fill it in — cards arrive in a four to five day window ending on each person's birthday — so the promise on the screen is the promise the floor works to. Full arithmetic in arrival windows.

#Why it cannot send two cards for one birthday

This is the failure everybody worries about, and it is guarded at the database rather than in the code that decides. Every card an automation creates first claims a unique (rule, contact, occurrence date) row. A second attempt at the same claim collides and stops. That is what makes the daily sweep safe: runs overlap on the dates they cover, and a date that has already been handled costs one rejected insert rather than one card.

It also means a Cloudflare cron retry, a deploy that overlaps a run, or you pressing Run now in the middle of a sweep cannot produce a duplicate. See how automations work.

#What about 29 February?

In a leap year the card goes out on the 29th. In every other year it goes out on 28 February. A card that arrives once every four years is a bug, not a policy.

#When it goes wrong