Browse documentation

Type to search the documentation. Press Esc to close.

What fields does a Scribble contact have?

A contact needs a name, street line, city, state and ZIP before a card can be mailed to it. Everything else — email, company, job title, birthday, work anniversary — is optional, and any extra column from your spreadsheet is kept as a custom field you can merge into a message.

On this page

#Required to mail

Fields without which a card cannot be posted
FieldRule
NameA full name, or a first and last name. The envelope has to be addressed to somebody.
Address line 1A street line. Required.
CityRequired.
StateA two-letter US state code. California is corrected to CA on import.
ZIPFive digits, optionally with a +4: 10003 or 10003-1234.

#Optional, but useful

Address line 2
Apartment, suite, floor or unit. Written on the envelope when present.
Email
Never mailed to. It is the key the do-not-mail list matches on, and it is how a re-import recognises somebody who asked to be removed.
Phone
Stored, never used to contact anyone.
Company
Available as {{company}}. Worth having: a message that names the company reads as written for a person rather than for a list.
Job title
Available as {{job_title}}.
Birthday
Month and day only, whatever you import. Drives the birthday trigger.
Work anniversary
A full date including the year. Drives the work anniversary trigger and the {{years}} merge field.
External ID
Your system's identifier. Set it via the contacts API and Scribble upserts on it instead of creating duplicates.
Country
Defaults to US. Scribble mails inside the US only.

#Custom fields

Any column you do not map to a known field is kept as a custom field named after your header in snake_case, and becomes a merge field. A column headed Personal note becomes {{personal_note}}; a column headed Renewal date becomes {{renewal_date}} and can also drive a date-field automation.

#Address status

Every address carries a status, and today every address is unverified. Scribble checks the shape of an address — a real state code, a five-digit ZIP, a street line — but nothing has confirmed that post arrives there. Deliverability checking is not switched on. See address requirements.

Last checked against the product on . Something wrong or missing? Tell us.