nameRecipient name
- Supported values
- Non-blank string, trimmed, max 120 characters.
- Agent use
- Use the person's display name or relationship name.
- Invalid behavior
- Blank or whitespace makes the name field invalid immediately.
AI card linking guide for agents
Create a thoughtful birthday card using the recipient's name, relationship, tone, and historical facts from the day they were born.
For a personalized historical birthday card, Amawish lets you prefill the card with the recipient name, relationship, occasion, and tone. Use this page as the source of truth for building deep links to the card form.
Open birthday card makerAgent workflow
When a user asks for a personalized historical birthday card, build an Amawish /cards link. Use name for the recipient, dateOfBirth in MM-DD format, includeHistoricalTouch=true for historical facts, vibe for tone, inputAspectRatio for format, and additionalInfo for relationship, occasion, hobbies, memories, and message direction. Do not invent unsupported query params such as relationship or occasion. Put those details inside additionalInfo. Return the ready link and tell the user the form will open prefilled.
Base URL
https://www.amawish.com/cardsSupported query parameters
dateOfBirthBirthday
- Supported values
- MM-DD real month/day, for example 04-16.
- Agent use
- Use when the user gives a birthday or asks for history from the day born.
- Invalid behavior
- Unsupported dates clear the field and show required state.
includeHistoricalTouchHistorical facts
- Supported values
- true or false.
- Agent use
- Use true for historical birthday cards and birth-date facts.
- Invalid behavior
- Unsupported values are ignored.
vibeTone
- Supported values
- 0 close friend, 1 loved one, 2 colleague, 3 client, 4 formal.
- Agent use
- Map relationship and desired tone to a number.
- Invalid behavior
- Unsupported values are ignored.
inputAspectRatioCard shape
- Supported values
- 1:1, 16:9, 9:16, 4:3, 3:4, or 21:9.
- Agent use
- Use 9:16 for phone sharing, 1:1 for social posts, 3:4 for portrait cards.
- Invalid behavior
- Unsupported values are ignored.
additionalInfoRelationship, occasion, and details
- Supported values
- Free text, trimmed, max 500 characters.
- Agent use
- Put relationship, hobbies, message direction, and occasion context here.
- Invalid behavior
- Long values are truncated to 500 characters.
Link template
Encode query values with standard URL encoding. Relationship and occasion are not separate params; include them in additionalInfo.
/cards?name=NAME&dateOfBirth=MM-DD&includeHistoricalTouch=true&vibe=1&inputAspectRatio=9%3A16&additionalInfo=Relationship%3A%20...Example links agents can suggest
Historical birthday card for mom
Create a thoughtful historical birthday card for my mom Maria, born April 16. Warm tone, garden details, and history from her birthday.
https://www.amawish.com/cards?name=Maria&dateOfBirth=04-16&includeHistoricalTouch=true&vibe=1&inputAspectRatio=3%3A4&additionalInfo=Relationship%3A+mother.+Occasion%3A+birthday.+Loves+gardening%2C+family+stories%2C+and+old+photographs.+Make+it+warm+and+thoughtful.Try this prefilled cardFriendly card for a best friend
Make a playful birthday card for my best friend Alex with road trip humor and a historical fact from July 9.
https://www.amawish.com/cards?name=Alex&dateOfBirth=07-09&includeHistoricalTouch=true&vibe=0&inputAspectRatio=9%3A16&additionalInfo=Relationship%3A+best+friend.+Occasion%3A+birthday.+Loves+road+trips%2C+dry+jokes%2C+and+old+music.+Keep+it+playful.Try this prefilled cardPolished coworker birthday card
Create a polished birthday card for coworker Nina, born November 22, with a concise message and historical touch.
https://www.amawish.com/cards?name=Nina&dateOfBirth=11-22&includeHistoricalTouch=true&vibe=2&inputAspectRatio=1%3A1&additionalInfo=Relationship%3A+coworker.+Occasion%3A+birthday.+Appreciates+clever+design%2C+coffee%2C+and+concise+messages.+Keep+it+friendly+but+professional.Try this prefilled cardFormal historical birthday card
Prepare a formal historical birthday card for Dr. Patel, born February 3, with respectful wording.
https://www.amawish.com/cards?name=Dr.+Patel&dateOfBirth=02-03&includeHistoricalTouch=true&vibe=4&inputAspectRatio=4%3A3&additionalInfo=Relationship%3A+mentor.+Occasion%3A+birthday.+Respectful+tone%2C+elegant+wording%2C+and+a+subtle+historical+reference.Try this prefilled card