Monica
App · 57 actions
Keep Monica, your personal CRM, up to date without opening it: add people and their details, write notes, log activities and calls, set reminders and tasks, tag contacts and note gifts and debts. Start a workflow when a contact, note, activity, task or journal entry is added, or when a reminder or birthday comes due.
Actions
| Action | What it does |
|---|---|
| Add address | Add an address to a contact, such as their home or work. |
| Add contact field | Add an email address, phone number or social handle to a contact. |
| Add debt | Note money a contact owes you, or you owe them. |
| Add gift | Note a gift for a contact: an idea for later, one you gave or one they gave you. |
| Add journal entry | Write an entry in your Monica journal for today. |
| Add note | Write a note about a contact, such as what they told you last time. |
| Add tags to contact | Put one or more tags on a contact, such as family or book club. |
| Complete task | Mark a task as done. |
| Create contact | Add a person to Monica, with their name, nickname, gender, date of birth and a short description. |
| Create relationship | Link two contacts, such as making one the partner, child or colleague of the other. |
| Create reminder | Have Monica remind you of something about a contact, once or every so many weeks, months or years. |
| Create task | Add a task, about a contact or on its own, such as Send the photos. |
| Delete activity | Delete an activity. |
| Delete address | Remove an address from a contact. |
| Delete call | Delete a logged call. |
| Delete contact | Delete a contact with everything kept about them: notes, activities, reminders, tasks and gifts. |
| Delete contact field | Remove an email address, phone number or handle from a contact. |
| Delete debt | Delete a debt. |
| Delete gift | Delete a gift. |
| Delete journal entry | Delete a journal entry. |
| Delete note | Delete a note. |
| Delete relationship | Remove the link between two contacts, in both directions. |
| Delete reminder | Delete a reminder. |
| Delete tag | Delete a tag from the account, taking it off every contact that has it. |
| Delete task | Delete a task. |
| Find contacts | Find contacts by words in their name, nickname, job, email or anything else Monica searches, or list them all, newest first. |
| Get contact | Get a contact with their emails, phone numbers, addresses, tags, work, birthday and how many notes, activities and reminders they have. |
| List activities | List what you've done with one contact or with everyone, newest first. |
| List activity types | List the kinds of activity the account offers, such as ate at a restaurant or went to the theater. |
| List addresses | List a contact's addresses. |
| List calls | List the phone calls logged with one contact or with everyone, newest first. |
| List contact field types | List the kinds of contact detail the account offers, such as Email, Phone, Twitter and LinkedIn. |
| List contact fields | List a contact's emails, phone numbers and social handles. |
| List debts | List the debts between you and one contact or everyone, settled or not. |
| List genders | List the genders the account offers for a contact. |
| List gifts | List the gifts noted for one contact or for everyone: ideas, given and received. |
| List journal entries | List your journal entries, newest first. |
| List notes | List the notes kept about one contact or about everyone, newest first. |
| List relationship types | List the kinds of relationship the account offers, such as partner, child, friend and colleague. |
| List relationships | List the people a contact is related to: partner, children, friends, colleagues. |
| List reminders | List the reminders kept for one contact or for everyone, with the next day each is due. |
| List tags | List every tag in the account. |
| List tasks | List the tasks to do for one contact or for everyone: those not done, those done, or all. |
| List upcoming reminders | List the reminders due in the next days, birthdays among them, soonest first, such as for a weekly digest. |
| Log activity | Record something you did with one or more contacts, such as a dinner or a walk, with the day and what happened. |
| Log call | Record a phone call with a contact: the day, who called and what was said. |
| Remove tags from contact | Take one or more tags off a contact. |
| Set contact's work | Set a contact's job title, where they work, or both. |
| Set food preferences | Write down what a contact likes or can't eat, such as vegetarian or allergic to nuts. |
| Set how you met | Write down how and when you met a contact. |
| Settle debt | Mark a debt as paid back. |
| Update activity | Change an activity's summary, day, type, description or who took part. |
| Update address | Change parts of a contact's address. |
| Update contact | Change a contact's name, nickname, gender, date of birth or description, or mark them as deceased. |
| Update contact field | Change an email address, phone number or handle a contact has, or what type it is. |
| Update note | Rewrite a note or change whether it's starred. |
| Update reminder | Change a reminder's title, day, how often it repeats or its description. |
Add address
Add an address to a contact, such as their home or work.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Label
nametext - What the address is, such as Home or Work.
- Street
streettext - Street and number.
- City
citytext - City or town.
- State or province
provincetext - State, province or region.
- Postal code
postal_codetext - Postal or ZIP code.
- Country
countrytext - The country's English name, such as France, or its two-letter code, such as FR.
Outputs
citytext- City
contact_idnumber- The number of the contact it belongs to
contact_nametext- That contact's name
countrytext- Country name
country_codetext- The country's two-letter code, such as US
idnumber- The address's number, which other Monica steps take
nametext- What the address is, such as Home
postal_codetext- Postal code
provincetext- State or province
streettext- Street
texttext- The address on one line
Example output
{
"city": "London",
"contact_id": 12,
"contact_name": "Ada Lovelace",
"country": "United Kingdom",
"country_code": "GB",
"id": 4,
"name": "Home",
"postal_code": "SW1Y 4JH",
"province": "",
"street": "12 St James's Square",
"text": "12 St James's Square, London, SW1Y 4JH, United Kingdom"
}Add contact field
Add an email address, phone number or social handle to a contact.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Type
field_typetextRequired - What it is, such as Email, Phone or Twitter.
- Value
valuetextRequired - The address, number or handle, such as ada@example.com.
Outputs
contact_idnumber- The number of the contact it belongs to
contact_nametext- That contact's name
idnumber- The contact field's number, which other Monica steps take
typetext- What it is, such as Email, Phone or Twitter
type_idnumber- That type's number
valuetext- The address, number or handle
Example output
{
"contact_id": 12,
"contact_name": "Ada Lovelace",
"id": 31,
"type": "Email",
"type_id": 1,
"value": "ada@example.com"
}Add debt
Note money a contact owes you, or you owe them.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Amount
amountnumberRequired - How much, in the account's currency.From 0 to 1000000000.
- Who owes
directiontext - Who owes whom. Defaults to they owe you.One of:
they_owe(They owe you),i_owe(You owe them). Default:they_owe. - Reason
reasontext - What it's for.
Outputs
amountnumber- How much
amount_texttext- The amount with its currency, such as $50.00
contact_idnumber- The number of the contact it belongs to
contact_nametext- That contact's name
created_attext- When the debt was noted
directiontext- i_owe (you owe the contact) or they_owe (they owe you)
idnumber- The debt's number, which other Monica steps take
reasontext- What it's for
settledtrue/false- Whether it has been paid back
Example output
{
"amount": 50,
"amount_text": "$50.00",
"contact_id": 12,
"contact_name": "Ada Lovelace",
"created_at": "2026-11-02T18:00:00Z",
"direction": "they_owe",
"id": 2,
"reason": "Concert tickets",
"settled": false
}Add gift
Note a gift for a contact: an idea for later, one you gave or one they gave you.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Gift
nametextRequired - What the gift is.
- Status
statustext - Whether it's an idea, given or received. Defaults to an idea.One of:
idea(An idea),offered(You gave it),received(They gave it to you). Default:idea. - Comment
commenttext - A note about it.
- Link
urltext - A link to it, such as a shop page.
- Price
amountnumber - What it costs, in the account's currency.From 0 to 1000000000.
- Date
given_ondate - The day it was given.
Outputs
amountnumber- What it costs, empty when not given
amount_texttext- The cost with its currency, such as $20.00
commenttext- A note about it
contact_idnumber- The number of the contact it belongs to
contact_nametext- That contact's name
created_attext- When the gift was noted
datetext- The day it was given (YYYY-MM-DD), blank when not given
idnumber- The gift's number, which other Monica steps take
nametext- What the gift is
statustext- idea, offered (you gave it) or received (they gave it)
urltext- A link to it, such as a shop page
Example output
{
"amount": 45,
"amount_text": "$45.00",
"comment": "Mentioned she lost hers",
"contact_id": 12,
"contact_name": "Ada Lovelace",
"created_at": "2026-11-02T18:00:00Z",
"date": "",
"id": 3,
"name": "Fountain pen",
"status": "idea",
"url": "https://example.com/pens/42"
}Add journal entry
Write an entry in your Monica journal for today.
Inputs
- Title
titletextRequired - The entry's title.
- Entry
posttextRequired - What to write.
Outputs
created_attext- When the entry was written
datetext- The day it's for (YYYY-MM-DD)
idnumber- The entry's number, which other Monica steps take
posttext- What was written
titletext- The entry's title
Example output
{
"created_at": "2026-11-02T18:00:00Z",
"date": "2026-11-02",
"id": 11,
"post": "Went up the hill with Ada and talked for hours.",
"title": "A long walk"
}Add note
Write a note about a contact, such as what they told you last time.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Note
bodytextRequired - The note's text.
- Favorite
favoritetrue/false - Star the note so it stands out.Default:
false.
Outputs
bodytext- The note's text
contact_idnumber- The number of the contact it belongs to
contact_nametext- That contact's name
created_attext- When the note was written
idnumber- The note's number, which other Monica steps take
is_favoritetrue/false- Whether the note is starred
updated_attext- When the note last changed
Example output
{
"body": "Starting a new job in January.",
"contact_id": 12,
"contact_name": "Ada Lovelace",
"created_at": "2026-11-02T18:00:00Z",
"id": 21,
"is_favorite": false,
"updated_at": "2026-11-02T18:00:00Z"
}Add tags to contact
Put one or more tags on a contact, such as family or book club. A tag that doesn't exist yet is made.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Tags
tagstextRequired - The tags' names, separated by commas.
Outputs
agenumber- Age in years, empty when the year of birth is unknown
birthdatetext- Date of birth (YYYY-MM-DD), blank when unknown or only the age or the day is known
birthdaytext- The birthday's month and day (MM-DD), blank when unknown
companytext- Where they work
created_attext- When the contact was added
descriptiontext- The short description under the contact's name
first_met_ontext- When you first met (YYYY-MM-DD), blank when unknown
first_nametext- First name
food_preferencestext- What they like or can't eat
gendertext- Gender, such as Woman
how_you_mettext- How you met
idnumber- The contact's number, which other Monica steps take
is_deceasedtrue/false- Whether the contact has died
is_starredtrue/false- Whether the contact is a favorite
jobtext- Job title
last_activity_ontext- When you last did something together (YYYY-MM-DD), blank when never
last_called_ontext- When you last called (YYYY-MM-DD), blank when never
last_nametext- Last name
linktext- Where the contact opens in Monica
nametext- The contact's full name as Monica shows it
nicknametext- Nickname
tagslist- The names of the contact's tags
updated_attext- When the contact last changed
Example output
{
"age": 35,
"birthdate": "1990-12-10",
"birthday": "12-10",
"company": "Analytical Engines Ltd",
"created_at": "2026-01-05T09:30:00Z",
"description": "Met at the maths society",
"first_met_on": "2015-06-05",
"first_name": "Ada",
"food_preferences": "Vegetarian",
"gender": "Woman",
"how_you_met": "At a lecture",
"id": 12,
"is_deceased": false,
"is_starred": false,
"job": "Analyst",
"last_activity_on": "2026-10-20",
"last_called_on": "2026-11-02",
"last_name": "Lovelace",
"link": "https://app.monicahq.com/people/h:4G7r3K91nkYn2LWe5m",
"name": "Ada Lovelace",
"nickname": "",
"tags": [
"friend"
],
"updated_at": "2026-11-02T18:00:00Z"
}Complete task
Mark a task as done.
Inputs
- Task
tasktextRequired - The task's number, from the Monica step that added or listed it.
Outputs
completedtrue/false- Whether it's done
completed_attext- When it was done, blank when it isn't
contact_idnumber- The number of the contact it belongs to
contact_nametext- That contact's name
created_attext- When the task was added
descriptiontext- More about it
idnumber- The task's number, which other Monica steps take
titletext- What there is to do
Example output
{
"completed": false,
"completed_at": "",
"contact_id": 12,
"contact_name": "Ada Lovelace",
"created_at": "2026-11-02T18:00:00Z",
"description": "",
"id": 9,
"title": "Send the photos from the trip"
}Create contact
Add a person to Monica, with their name, nickname, gender, date of birth and a short description.
Inputs
- First name
first_nametextRequired - The contact's first name, such as Ada.
- Last name
last_nametext - The contact's last name.
- Nickname
nicknametext - What they go by.
- Gender
gendertext - The contact's gender, such as Woman.
- Date of birth
birthdatedate - The day they were born.
- Remind me of the birthday
birthday_remindertrue/false - Have Monica keep a yearly reminder of the birthday. Needs a date of birth.Default:
false. - Description
descriptiontext - A short line shown under the contact's name, up to 255 characters.
- Deceased
is_deceasedtrue/false - Whether the contact has died.Default:
false.
Outputs
agenumber- Age in years, empty when the year of birth is unknown
birthdatetext- Date of birth (YYYY-MM-DD), blank when unknown or only the age or the day is known
birthdaytext- The birthday's month and day (MM-DD), blank when unknown
companytext- Where they work
created_attext- When the contact was added
descriptiontext- The short description under the contact's name
first_met_ontext- When you first met (YYYY-MM-DD), blank when unknown
first_nametext- First name
food_preferencestext- What they like or can't eat
gendertext- Gender, such as Woman
how_you_mettext- How you met
idnumber- The contact's number, which other Monica steps take
is_deceasedtrue/false- Whether the contact has died
is_starredtrue/false- Whether the contact is a favorite
jobtext- Job title
last_activity_ontext- When you last did something together (YYYY-MM-DD), blank when never
last_called_ontext- When you last called (YYYY-MM-DD), blank when never
last_nametext- Last name
linktext- Where the contact opens in Monica
nametext- The contact's full name as Monica shows it
nicknametext- Nickname
tagslist- The names of the contact's tags
updated_attext- When the contact last changed
Example output
{
"age": 35,
"birthdate": "1990-12-10",
"birthday": "12-10",
"company": "Analytical Engines Ltd",
"created_at": "2026-01-05T09:30:00Z",
"description": "Met at the maths society",
"first_met_on": "2015-06-05",
"first_name": "Ada",
"food_preferences": "Vegetarian",
"gender": "Woman",
"how_you_met": "At a lecture",
"id": 12,
"is_deceased": false,
"is_starred": false,
"job": "Analyst",
"last_activity_on": "2026-10-20",
"last_called_on": "2026-11-02",
"last_name": "Lovelace",
"link": "https://app.monicahq.com/people/h:4G7r3K91nkYn2LWe5m",
"name": "Ada Lovelace",
"nickname": "",
"tags": [
"friend"
],
"updated_at": "2026-11-02T18:00:00Z"
}Create relationship
Link two contacts, such as making one the partner, child or colleague of the other. Monica adds the link back on the other contact.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Relationship
relationship_typetextRequired - What the other person is to the contact, such as partner, child or friend.
- Other contact
other_contacttextRequired - The other person: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
Outputs
contact_idnumber- The number of the contact it belongs to
contact_nametext- That contact's name
idnumber- The relationship's number, which other Monica steps take
other_contact_idnumber- The other person's number
other_contact_nametext- The other person's name
relationshiptext- What the other person is to the contact, such as child
relationship_type_idnumber- That kind of relationship's number
Example output
{
"contact_id": 12,
"contact_name": "Ada Lovelace",
"id": 6,
"other_contact_id": 15,
"other_contact_name": "Byron Lovelace",
"relationship": "child",
"relationship_type_id": 9
}Create reminder
Have Monica remind you of something about a contact, once or every so many weeks, months or years.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Title
titletextRequired - What to be reminded of, such as Call about the house move.
- Date
remind_ondateRequired - The day to be reminded, and the first one when it repeats.
- Repeats
repeatstext - How often it comes back. Defaults to once.One of:
one_time(Once),week(Weekly),month(Monthly),year(Yearly). Default:one_time. - Every
everynumber - How many weeks, months or years between repeats, such as 2 for every second week. Defaults to 1.From 1 to 100.
- Description
descriptiontext - More about it.
Outputs
contact_idnumber- The number of the contact it belongs to
contact_nametext- That contact's name
created_attext- When the reminder was made
datetext- The day it's first for (YYYY-MM-DD)
days_untilnumber- Days until then, 0 for today, empty when passed
descriptiontext- More about it
everynumber- How many weeks, months or years between repeats
idnumber- The reminder's number, which other Monica steps take
is_birthdaytrue/false- Whether Monica made it for a birthday
next_datetext- The next day it's due (YYYY-MM-DD), blank when it was for one day that has passed
repeatstext- one_time, week, month or year
titletext- What to be reminded of
Example output
{
"contact_id": 12,
"contact_name": "Ada Lovelace",
"created_at": "2026-01-05T09:30:00Z",
"date": "1990-12-10",
"days_until": 23,
"description": "",
"every": 1,
"id": 14,
"is_birthday": true,
"next_date": "2026-12-10",
"repeats": "year",
"title": "Wish happy birthday to Ada"
}Create task
Add a task, about a contact or on its own, such as Send the photos.
Inputs
- Title
titletextRequired - What there is to do.
- Contact
contacttext - The contact it's about. Leave blank for a task of your own.
- Description
descriptiontext - More about it.
Outputs
completedtrue/false- Whether it's done
completed_attext- When it was done, blank when it isn't
contact_idnumber- The number of the contact it belongs to
contact_nametext- That contact's name
created_attext- When the task was added
descriptiontext- More about it
idnumber- The task's number, which other Monica steps take
titletext- What there is to do
Example output
{
"completed": false,
"completed_at": "",
"contact_id": 12,
"contact_name": "Ada Lovelace",
"created_at": "2026-11-02T18:00:00Z",
"description": "",
"id": 9,
"title": "Send the photos from the trip"
}Delete activity
Delete an activity.
Inputs
- Activity
activitytextRequired - The activity's number, from the Monica step that added or listed it.
Outputs
deletedtrue/false- Whether Monica deleted it
idnumber- The number of what was deleted
Example output
{
"deleted": true,
"id": 7
}Delete address
Remove an address from a contact.
Inputs
- Address
addresstextRequired - The address's number, from the Monica step that added or listed it.
Outputs
deletedtrue/false- Whether Monica deleted it
idnumber- The number of what was deleted
Example output
{
"deleted": true,
"id": 7
}Delete call
Delete a logged call.
Inputs
- Call
calltextRequired - The call's number, from the Monica step that added or listed it.
Outputs
deletedtrue/false- Whether Monica deleted it
idnumber- The number of what was deleted
Example output
{
"deleted": true,
"id": 7
}Delete contact
Delete a contact with everything kept about them: notes, activities, reminders, tasks and gifts. This can't be undone.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
Outputs
deletedtrue/false- Whether Monica deleted it
idnumber- The number of what was deleted
Example output
{
"deleted": true,
"id": 7
}Delete contact field
Remove an email address, phone number or handle from a contact.
Inputs
- Contact field
contact_fieldtextRequired - The contact field's number, from the Monica step that added or listed it.
Outputs
deletedtrue/false- Whether Monica deleted it
idnumber- The number of what was deleted
Example output
{
"deleted": true,
"id": 7
}Delete debt
Delete a debt.
Inputs
- Debt
debttextRequired - The debt's number, from the Monica step that added or listed it.
Outputs
deletedtrue/false- Whether Monica deleted it
idnumber- The number of what was deleted
Example output
{
"deleted": true,
"id": 7
}Delete gift
Delete a gift.
Inputs
- Gift
gifttextRequired - The gift's number, from the Monica step that added or listed it.
Outputs
deletedtrue/false- Whether Monica deleted it
idnumber- The number of what was deleted
Example output
{
"deleted": true,
"id": 7
}Delete journal entry
Delete a journal entry.
Inputs
- Journal entry
entrytextRequired - The journal entry's number, from the Monica step that added or listed it.
Outputs
deletedtrue/false- Whether Monica deleted it
idnumber- The number of what was deleted
Example output
{
"deleted": true,
"id": 7
}Delete note
Delete a note.
Inputs
- Note
notetextRequired - The note's number, from the Monica step that added or listed it.
Outputs
deletedtrue/false- Whether Monica deleted it
idnumber- The number of what was deleted
Example output
{
"deleted": true,
"id": 7
}Delete relationship
Remove the link between two contacts, in both directions.
Inputs
- Relationship
relationshiptextRequired - The relationship's number, from the Monica step that added or listed it.
Outputs
deletedtrue/false- Whether Monica deleted it
idnumber- The number of what was deleted
Example output
{
"deleted": true,
"id": 7
}Delete reminder
Delete a reminder.
Inputs
- Reminder
remindertextRequired - The reminder's number, from the Monica step that added or listed it.
Outputs
deletedtrue/false- Whether Monica deleted it
idnumber- The number of what was deleted
Example output
{
"deleted": true,
"id": 7
}Delete tag
Delete a tag from the account, taking it off every contact that has it.
Inputs
- Tag
tagtextRequired - The tag's name, or its number from 'List tags'.
Outputs
deletedtrue/false- Whether Monica deleted it
idnumber- The number of what was deleted
Example output
{
"deleted": true,
"id": 7
}Delete task
Delete a task.
Inputs
- Task
tasktextRequired - The task's number, from the Monica step that added or listed it.
Outputs
deletedtrue/false- Whether Monica deleted it
idnumber- The number of what was deleted
Example output
{
"deleted": true,
"id": 7
}Find contacts
Find contacts by words in their name, nickname, job, email or anything else Monica searches, or list them all, newest first.
Inputs
- Search
querytext - Words to look for, such as a name or an email address. Leave blank for every contact.
- Order
ordertext - Which contacts come first. Defaults to the newest.One of:
newest(Newest first),updated(Recently changed first),oldest(Oldest first). Default:newest. - Limit
limitnumber - The most to return, newest first. Defaults to 50.From 1 to 500.
Outputs
contactslist- Each contact found
countnumber- How many are listed
Example output
{
"contacts": [
{
"age": 35,
"birthdate": "1990-12-10",
"birthday": "12-10",
"company": "Analytical Engines Ltd",
"created_at": "2026-01-05T09:30:00Z",
"description": "Met at the maths society",
"first_met_on": "2015-06-05",
"first_name": "Ada",
"food_preferences": "Vegetarian",
"gender": "Woman",
"how_you_met": "At a lecture",
"id": 12,
"is_deceased": false,
"is_starred": false,
"job": "Analyst",
"last_activity_on": "2026-10-20",
"last_called_on": "2026-11-02",
"last_name": "Lovelace",
"link": "https://app.monicahq.com/people/h:4G7r3K91nkYn2LWe5m",
"name": "Ada Lovelace",
"nickname": "",
"tags": [
"friend"
],
"updated_at": "2026-11-02T18:00:00Z"
}
],
"count": 1
}Get contact
Get a contact with their emails, phone numbers, addresses, tags, work, birthday and how many notes, activities and reminders they have.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
Outputs
activities_countnumber- How many activities you've logged together
addresseslist- The contact's addresses
agenumber- Age in years, empty when the year of birth is unknown
birthdatetext- Date of birth (YYYY-MM-DD), blank when unknown or only the age or the day is known
birthdaytext- The birthday's month and day (MM-DD), blank when unknown
calls_countnumber- How many calls you've logged
companytext- Where they work
contact_fieldslist- Every way to reach the contact: emails, phones and social handles
created_attext- When the contact was added
descriptiontext- The short description under the contact's name
emailslist- The contact's email addresses
first_met_ontext- When you first met (YYYY-MM-DD), blank when unknown
first_nametext- First name
food_preferencestext- What they like or can't eat
gendertext- Gender, such as Woman
gifts_countnumber- How many gifts are noted for the contact
how_you_mettext- How you met
idnumber- The contact's number, which other Monica steps take
is_deceasedtrue/false- Whether the contact has died
is_starredtrue/false- Whether the contact is a favorite
jobtext- Job title
last_activity_ontext- When you last did something together (YYYY-MM-DD), blank when never
last_called_ontext- When you last called (YYYY-MM-DD), blank when never
last_nametext- Last name
linktext- Where the contact opens in Monica
nametext- The contact's full name as Monica shows it
nicknametext- Nickname
notes_countnumber- How many notes the contact has
phoneslist- The contact's phone numbers
reminders_countnumber- How many reminders the contact has
tagslist- The names of the contact's tags
tasks_countnumber- How many tasks the contact has
updated_attext- When the contact last changed
Example output
{
"activities_count": 2,
"addresses": [
{
"city": "London",
"contact_id": 12,
"contact_name": "Ada Lovelace",
"country": "United Kingdom",
"country_code": "GB",
"id": 4,
"name": "Home",
"postal_code": "SW1Y 4JH",
"province": "",
"street": "12 St James's Square",
"text": "12 St James's Square, London, SW1Y 4JH, United Kingdom"
}
],
"age": 35,
"birthdate": "1990-12-10",
"birthday": "12-10",
"calls_count": 1,
"company": "Analytical Engines Ltd",
"contact_fields": [
{
"contact_id": 12,
"contact_name": "Ada Lovelace",
"id": 31,
"type": "Email",
"type_id": 1,
"value": "ada@example.com"
}
],
"created_at": "2026-01-05T09:30:00Z",
"description": "Met at the maths society",
"emails": [
"ada@example.com"
],
"first_met_on": "2015-06-05",
"first_name": "Ada",
"food_preferences": "Vegetarian",
"gender": "Woman",
"gifts_count": 0,
"how_you_met": "At a lecture",
"id": 12,
"is_deceased": false,
"is_starred": false,
"job": "Analyst",
"last_activity_on": "2026-10-20",
"last_called_on": "2026-11-02",
"last_name": "Lovelace",
"link": "https://app.monicahq.com/people/h:4G7r3K91nkYn2LWe5m",
"name": "Ada Lovelace",
"nickname": "",
"notes_count": 3,
"phones": [
"+44 20 7946 0018"
],
"reminders_count": 1,
"tags": [
"friend"
],
"tasks_count": 1,
"updated_at": "2026-11-02T18:00:00Z"
}List activities
List what you've done with one contact or with everyone, newest first.
Inputs
- Contact
contacttext - Only this contact's. Leave blank for everyone's.
- Limit
limitnumber - The most to return, newest first. Defaults to 50.From 1 to 500.
Outputs
activitieslist- Each activity, newest first
countnumber- How many are listed
Example output
{
"activities": [
{
"activity_type": "ate at a restaurant",
"contact_names": "Ada Lovelace",
"contacts": [
{
"id": 12,
"name": "Ada Lovelace"
}
],
"created_at": "2026-10-21T08:15:00Z",
"description": "Talked about the move to Lisbon.",
"happened_on": "2026-10-20",
"id": 8,
"summary": "Dinner at Luigi's"
}
],
"count": 1
}List activity types
List the kinds of activity the account offers, such as ate at a restaurant or went to the theater.
Inputs
None.
Outputs
activity_typeslist- Each kind of activity the account offers
countnumber- How many are listed
Example output
{
"activity_types": [
{
"category": "Food",
"id": 5,
"name": "ate at a restaurant"
}
],
"count": 1
}List addresses
List a contact's addresses.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
Outputs
addresseslist- Each address
countnumber- How many are listed
Example output
{
"addresses": [
{
"city": "London",
"contact_id": 12,
"contact_name": "Ada Lovelace",
"country": "United Kingdom",
"country_code": "GB",
"id": 4,
"name": "Home",
"postal_code": "SW1Y 4JH",
"province": "",
"street": "12 St James's Square",
"text": "12 St James's Square, London, SW1Y 4JH, United Kingdom"
}
],
"count": 1
}List calls
List the phone calls logged with one contact or with everyone, newest first.
Inputs
- Contact
contacttext - Only this contact's. Leave blank for everyone's.
- Limit
limitnumber - The most to return, newest first. Defaults to 50.From 1 to 500.
Outputs
callslist- Each call, newest first
countnumber- How many are listed
Example output
{
"calls": [
{
"called_on": "2026-11-02",
"contact_id": 12,
"contact_name": "Ada Lovelace",
"content": "Caught up about the holidays.",
"created_at": "2026-11-02T18:00:00Z",
"id": 5,
"who_called": "me"
}
],
"count": 1
}List contact field types
List the kinds of contact detail the account offers, such as Email, Phone, Twitter and LinkedIn.
Inputs
None.
Outputs
contact_field_typeslist- Each kind of contact detail the account offers
countnumber- How many are listed
Example output
{
"contact_field_types": [
{
"id": 1,
"name": "Email",
"type": "email"
}
],
"count": 1
}List contact fields
List a contact's emails, phone numbers and social handles.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
Outputs
contact_fieldslist- Each email, phone number or handle
countnumber- How many are listed
Example output
{
"contact_fields": [
{
"contact_id": 12,
"contact_name": "Ada Lovelace",
"id": 31,
"type": "Email",
"type_id": 1,
"value": "ada@example.com"
}
],
"count": 1
}List debts
List the debts between you and one contact or everyone, settled or not.
Inputs
- Contact
contacttext - Only this contact's. Leave blank for everyone's.
- Limit
limitnumber - The most to return, newest first. Defaults to 50.From 1 to 500.
Outputs
countnumber- How many are listed
debtslist- Each debt, newest first
Example output
{
"count": 1,
"debts": [
{
"amount": 50,
"amount_text": "$50.00",
"contact_id": 12,
"contact_name": "Ada Lovelace",
"created_at": "2026-11-02T18:00:00Z",
"direction": "they_owe",
"id": 2,
"reason": "Concert tickets",
"settled": false
}
]
}List genders
List the genders the account offers for a contact.
Inputs
None.
Outputs
countnumber- How many are listed
genderslist- Each gender the account offers
Example output
{
"count": 1,
"genders": [
{
"id": 2,
"name": "Woman"
}
]
}List gifts
List the gifts noted for one contact or for everyone: ideas, given and received.
Inputs
- Contact
contacttext - Only this contact's. Leave blank for everyone's.
- Limit
limitnumber - The most to return, newest first. Defaults to 50.From 1 to 500.
Outputs
countnumber- How many are listed
giftslist- Each gift, newest first
Example output
{
"count": 1,
"gifts": [
{
"amount": 45,
"amount_text": "$45.00",
"comment": "Mentioned she lost hers",
"contact_id": 12,
"contact_name": "Ada Lovelace",
"created_at": "2026-11-02T18:00:00Z",
"date": "",
"id": 3,
"name": "Fountain pen",
"status": "idea",
"url": "https://example.com/pens/42"
}
]
}List journal entries
List your journal entries, newest first.
Inputs
- Limit
limitnumber - The most to return, newest first. Defaults to 50.From 1 to 500.
Outputs
countnumber- How many are listed
entrieslist- Each journal entry, newest first
Example output
{
"count": 1,
"entries": [
{
"created_at": "2026-11-02T18:00:00Z",
"date": "2026-11-02",
"id": 11,
"post": "Went up the hill with Ada and talked for hours.",
"title": "A long walk"
}
]
}List notes
List the notes kept about one contact or about everyone, newest first.
Inputs
- Contact
contacttext - Only this contact's. Leave blank for everyone's.
- Limit
limitnumber - The most to return, newest first. Defaults to 50.From 1 to 500.
Outputs
countnumber- How many are listed
noteslist- Each note, newest first
Example output
{
"count": 1,
"notes": [
{
"body": "Starting a new job in January.",
"contact_id": 12,
"contact_name": "Ada Lovelace",
"created_at": "2026-11-02T18:00:00Z",
"id": 21,
"is_favorite": false,
"updated_at": "2026-11-02T18:00:00Z"
}
]
}List relationship types
List the kinds of relationship the account offers, such as partner, child, friend and colleague.
Inputs
None.
Outputs
countnumber- How many are listed
relationship_typeslist- Each kind of relationship the account offers
Example output
{
"count": 1,
"relationship_types": [
{
"id": 9,
"name": "child",
"reverse_name": "parent"
}
]
}List relationships
List the people a contact is related to: partner, children, friends, colleagues.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
Outputs
countnumber- How many are listed
relationshipslist- Each person the contact is related to
Example output
{
"count": 1,
"relationships": [
{
"contact_id": 12,
"contact_name": "Ada Lovelace",
"id": 6,
"other_contact_id": 15,
"other_contact_name": "Byron Lovelace",
"relationship": "child",
"relationship_type_id": 9
}
]
}List reminders
List the reminders kept for one contact or for everyone, with the next day each is due.
Inputs
- Contact
contacttext - Only this contact's. Leave blank for everyone's.
- Limit
limitnumber - The most to return, newest first. Defaults to 50.From 1 to 500.
Outputs
countnumber- How many are listed
reminderslist- Each reminder
Example output
{
"count": 1,
"reminders": [
{
"contact_id": 12,
"contact_name": "Ada Lovelace",
"created_at": "2026-01-05T09:30:00Z",
"date": "1990-12-10",
"days_until": 23,
"description": "",
"every": 1,
"id": 14,
"is_birthday": true,
"next_date": "2026-12-10",
"repeats": "year",
"title": "Wish happy birthday to Ada"
}
]
}List tags
List every tag in the account.
Inputs
None.
Outputs
countnumber- How many are listed
tagslist- Each tag in the account
Example output
{
"count": 1,
"tags": [
{
"id": 3,
"name": "friend"
}
]
}List tasks
List the tasks to do for one contact or for everyone: those not done, those done, or all.
Inputs
- Contact
contacttext - Only this contact's. Leave blank for everyone's.
- Status
statustext - Which tasks to list. Defaults to those not done.One of:
open(Not done),done,all. Default:open. - Limit
limitnumber - The most to return, newest first. Defaults to 50.From 1 to 500.
Outputs
countnumber- How many are listed
taskslist- Each task, newest first
Example output
{
"count": 1,
"tasks": [
{
"completed": false,
"completed_at": "",
"contact_id": 12,
"contact_name": "Ada Lovelace",
"created_at": "2026-11-02T18:00:00Z",
"description": "",
"id": 9,
"title": "Send the photos from the trip"
}
]
}List upcoming reminders
List the reminders due in the next days, birthdays among them, soonest first, such as for a weekly digest.
Inputs
- Days ahead
daysnumber - How many days ahead to look: 0 for today only. Defaults to 30.From 0 to 366.
Outputs
countnumber- How many are listed
reminderslist- Each reminder
Example output
{
"count": 1,
"reminders": [
{
"contact_id": 12,
"contact_name": "Ada Lovelace",
"created_at": "2026-01-05T09:30:00Z",
"date": "1990-12-10",
"days_until": 23,
"description": "",
"every": 1,
"id": 14,
"is_birthday": true,
"next_date": "2026-12-10",
"repeats": "year",
"title": "Wish happy birthday to Ada"
}
]
}Log activity
Record something you did with one or more contacts, such as a dinner or a walk, with the day and what happened.
Inputs
- Summary
summarytextRequired - What you did, in a few words, such as Dinner at Luigi's.
- Contacts
contactstextRequired - Who took part: contacts' numbers or names, separated by commas.
- Date
happened_ondate - The day it happened. Defaults to today.
- Activity type
activity_typetext - The kind of activity, such as ate at a restaurant.
- Description
descriptiontext - More about it: what you talked about, how it went.
Outputs
activity_typetext- The kind of activity, blank when none was chosen
contact_namestext- Their names, separated by commas
contactslist- The contacts who took part
created_attext- When the activity was logged
descriptiontext- More about it
happened_ontext- The day it happened (YYYY-MM-DD)
idnumber- The activity's number, which other Monica steps take
summarytext- What you did, in a few words
Example output
{
"activity_type": "ate at a restaurant",
"contact_names": "Ada Lovelace",
"contacts": [
{
"id": 12,
"name": "Ada Lovelace"
}
],
"created_at": "2026-10-21T08:15:00Z",
"description": "Talked about the move to Lisbon.",
"happened_on": "2026-10-20",
"id": 8,
"summary": "Dinner at Luigi's"
}Log call
Record a phone call with a contact: the day, who called and what was said.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Date
called_ondate - The day of the call. Defaults to today.
- What was said
contenttext - Notes on the call.
- Who called
who_calledtext - Who made the call. Defaults to you.One of:
me(You called),contact(They called). Default:me.
Outputs
called_ontext- The day of the call (YYYY-MM-DD)
contact_idnumber- The number of the contact it belongs to
contact_nametext- That contact's name
contenttext- What was said
created_attext- When the call was logged
idnumber- The call's number, which other Monica steps take
who_calledtext- me or contact: who made the call
Example output
{
"called_on": "2026-11-02",
"contact_id": 12,
"contact_name": "Ada Lovelace",
"content": "Caught up about the holidays.",
"created_at": "2026-11-02T18:00:00Z",
"id": 5,
"who_called": "me"
}Remove tags from contact
Take one or more tags off a contact. A tag the contact doesn't have is skipped.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Tags
tagstextRequired - The tags' names, separated by commas.
Outputs
agenumber- Age in years, empty when the year of birth is unknown
birthdatetext- Date of birth (YYYY-MM-DD), blank when unknown or only the age or the day is known
birthdaytext- The birthday's month and day (MM-DD), blank when unknown
companytext- Where they work
created_attext- When the contact was added
descriptiontext- The short description under the contact's name
first_met_ontext- When you first met (YYYY-MM-DD), blank when unknown
first_nametext- First name
food_preferencestext- What they like or can't eat
gendertext- Gender, such as Woman
how_you_mettext- How you met
idnumber- The contact's number, which other Monica steps take
is_deceasedtrue/false- Whether the contact has died
is_starredtrue/false- Whether the contact is a favorite
jobtext- Job title
last_activity_ontext- When you last did something together (YYYY-MM-DD), blank when never
last_called_ontext- When you last called (YYYY-MM-DD), blank when never
last_nametext- Last name
linktext- Where the contact opens in Monica
nametext- The contact's full name as Monica shows it
nicknametext- Nickname
tagslist- The names of the contact's tags
updated_attext- When the contact last changed
Example output
{
"age": 35,
"birthdate": "1990-12-10",
"birthday": "12-10",
"company": "Analytical Engines Ltd",
"created_at": "2026-01-05T09:30:00Z",
"description": "Met at the maths society",
"first_met_on": "2015-06-05",
"first_name": "Ada",
"food_preferences": "Vegetarian",
"gender": "Woman",
"how_you_met": "At a lecture",
"id": 12,
"is_deceased": false,
"is_starred": false,
"job": "Analyst",
"last_activity_on": "2026-10-20",
"last_called_on": "2026-11-02",
"last_name": "Lovelace",
"link": "https://app.monicahq.com/people/h:4G7r3K91nkYn2LWe5m",
"name": "Ada Lovelace",
"nickname": "",
"tags": [
"friend"
],
"updated_at": "2026-11-02T18:00:00Z"
}Set contact's work
Set a contact's job title, where they work, or both.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Job title
jobtext - What they do, such as Architect.
- Company
companytext - Where they work.
Outputs
agenumber- Age in years, empty when the year of birth is unknown
birthdatetext- Date of birth (YYYY-MM-DD), blank when unknown or only the age or the day is known
birthdaytext- The birthday's month and day (MM-DD), blank when unknown
companytext- Where they work
created_attext- When the contact was added
descriptiontext- The short description under the contact's name
first_met_ontext- When you first met (YYYY-MM-DD), blank when unknown
first_nametext- First name
food_preferencestext- What they like or can't eat
gendertext- Gender, such as Woman
how_you_mettext- How you met
idnumber- The contact's number, which other Monica steps take
is_deceasedtrue/false- Whether the contact has died
is_starredtrue/false- Whether the contact is a favorite
jobtext- Job title
last_activity_ontext- When you last did something together (YYYY-MM-DD), blank when never
last_called_ontext- When you last called (YYYY-MM-DD), blank when never
last_nametext- Last name
linktext- Where the contact opens in Monica
nametext- The contact's full name as Monica shows it
nicknametext- Nickname
tagslist- The names of the contact's tags
updated_attext- When the contact last changed
Example output
{
"age": 35,
"birthdate": "1990-12-10",
"birthday": "12-10",
"company": "Analytical Engines Ltd",
"created_at": "2026-01-05T09:30:00Z",
"description": "Met at the maths society",
"first_met_on": "2015-06-05",
"first_name": "Ada",
"food_preferences": "Vegetarian",
"gender": "Woman",
"how_you_met": "At a lecture",
"id": 12,
"is_deceased": false,
"is_starred": false,
"job": "Analyst",
"last_activity_on": "2026-10-20",
"last_called_on": "2026-11-02",
"last_name": "Lovelace",
"link": "https://app.monicahq.com/people/h:4G7r3K91nkYn2LWe5m",
"name": "Ada Lovelace",
"nickname": "",
"tags": [
"friend"
],
"updated_at": "2026-11-02T18:00:00Z"
}Set food preferences
Write down what a contact likes or can't eat, such as vegetarian or allergic to nuts. Replaces what was there.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Food preferences
food_preferencestextRequired - What they like or can't eat.
Outputs
agenumber- Age in years, empty when the year of birth is unknown
birthdatetext- Date of birth (YYYY-MM-DD), blank when unknown or only the age or the day is known
birthdaytext- The birthday's month and day (MM-DD), blank when unknown
companytext- Where they work
created_attext- When the contact was added
descriptiontext- The short description under the contact's name
first_met_ontext- When you first met (YYYY-MM-DD), blank when unknown
first_nametext- First name
food_preferencestext- What they like or can't eat
gendertext- Gender, such as Woman
how_you_mettext- How you met
idnumber- The contact's number, which other Monica steps take
is_deceasedtrue/false- Whether the contact has died
is_starredtrue/false- Whether the contact is a favorite
jobtext- Job title
last_activity_ontext- When you last did something together (YYYY-MM-DD), blank when never
last_called_ontext- When you last called (YYYY-MM-DD), blank when never
last_nametext- Last name
linktext- Where the contact opens in Monica
nametext- The contact's full name as Monica shows it
nicknametext- Nickname
tagslist- The names of the contact's tags
updated_attext- When the contact last changed
Example output
{
"age": 35,
"birthdate": "1990-12-10",
"birthday": "12-10",
"company": "Analytical Engines Ltd",
"created_at": "2026-01-05T09:30:00Z",
"description": "Met at the maths society",
"first_met_on": "2015-06-05",
"first_name": "Ada",
"food_preferences": "Vegetarian",
"gender": "Woman",
"how_you_met": "At a lecture",
"id": 12,
"is_deceased": false,
"is_starred": false,
"job": "Analyst",
"last_activity_on": "2026-10-20",
"last_called_on": "2026-11-02",
"last_name": "Lovelace",
"link": "https://app.monicahq.com/people/h:4G7r3K91nkYn2LWe5m",
"name": "Ada Lovelace",
"nickname": "",
"tags": [
"friend"
],
"updated_at": "2026-11-02T18:00:00Z"
}Set how you met
Write down how and when you met a contact.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- How you met
how_you_mettext - The story, such as At Sam's wedding.
- Date you met
met_ondate - The day you first met.
Outputs
agenumber- Age in years, empty when the year of birth is unknown
birthdatetext- Date of birth (YYYY-MM-DD), blank when unknown or only the age or the day is known
birthdaytext- The birthday's month and day (MM-DD), blank when unknown
companytext- Where they work
created_attext- When the contact was added
descriptiontext- The short description under the contact's name
first_met_ontext- When you first met (YYYY-MM-DD), blank when unknown
first_nametext- First name
food_preferencestext- What they like or can't eat
gendertext- Gender, such as Woman
how_you_mettext- How you met
idnumber- The contact's number, which other Monica steps take
is_deceasedtrue/false- Whether the contact has died
is_starredtrue/false- Whether the contact is a favorite
jobtext- Job title
last_activity_ontext- When you last did something together (YYYY-MM-DD), blank when never
last_called_ontext- When you last called (YYYY-MM-DD), blank when never
last_nametext- Last name
linktext- Where the contact opens in Monica
nametext- The contact's full name as Monica shows it
nicknametext- Nickname
tagslist- The names of the contact's tags
updated_attext- When the contact last changed
Example output
{
"age": 35,
"birthdate": "1990-12-10",
"birthday": "12-10",
"company": "Analytical Engines Ltd",
"created_at": "2026-01-05T09:30:00Z",
"description": "Met at the maths society",
"first_met_on": "2015-06-05",
"first_name": "Ada",
"food_preferences": "Vegetarian",
"gender": "Woman",
"how_you_met": "At a lecture",
"id": 12,
"is_deceased": false,
"is_starred": false,
"job": "Analyst",
"last_activity_on": "2026-10-20",
"last_called_on": "2026-11-02",
"last_name": "Lovelace",
"link": "https://app.monicahq.com/people/h:4G7r3K91nkYn2LWe5m",
"name": "Ada Lovelace",
"nickname": "",
"tags": [
"friend"
],
"updated_at": "2026-11-02T18:00:00Z"
}Settle debt
Mark a debt as paid back.
Inputs
- Debt
debttextRequired - The debt's number, from the Monica step that added or listed it.
Outputs
amountnumber- How much
amount_texttext- The amount with its currency, such as $50.00
contact_idnumber- The number of the contact it belongs to
contact_nametext- That contact's name
created_attext- When the debt was noted
directiontext- i_owe (you owe the contact) or they_owe (they owe you)
idnumber- The debt's number, which other Monica steps take
reasontext- What it's for
settledtrue/false- Whether it has been paid back
Example output
{
"amount": 50,
"amount_text": "$50.00",
"contact_id": 12,
"contact_name": "Ada Lovelace",
"created_at": "2026-11-02T18:00:00Z",
"direction": "they_owe",
"id": 2,
"reason": "Concert tickets",
"settled": false
}Update activity
Change an activity's summary, day, type, description or who took part. Anything left blank stays as it is.
Inputs
- Activity
activitytextRequired - The activity's number, from the Monica step that added or listed it.
- Summary
summarytext - What you did, in a few words, such as Dinner at Luigi's. Leave blank to keep it.
- Contacts
contactstext - Who took part: contacts' numbers or names, separated by commas. Leave blank to keep them.
- Date
happened_ondate - The day it happened. Leave blank to keep it.
- Activity type
activity_typetext - The kind of activity, such as ate at a restaurant. Leave blank to keep it.
- Description
descriptiontext - More about it: what you talked about, how it went. Leave blank to keep it.
Outputs
activity_typetext- The kind of activity, blank when none was chosen
contact_namestext- Their names, separated by commas
contactslist- The contacts who took part
created_attext- When the activity was logged
descriptiontext- More about it
happened_ontext- The day it happened (YYYY-MM-DD)
idnumber- The activity's number, which other Monica steps take
summarytext- What you did, in a few words
Example output
{
"activity_type": "ate at a restaurant",
"contact_names": "Ada Lovelace",
"contacts": [
{
"id": 12,
"name": "Ada Lovelace"
}
],
"created_at": "2026-10-21T08:15:00Z",
"description": "Talked about the move to Lisbon.",
"happened_on": "2026-10-20",
"id": 8,
"summary": "Dinner at Luigi's"
}Update address
Change parts of a contact's address. Anything left blank stays as it is.
Inputs
- Address
addresstextRequired - The address's number, from the Monica step that added or listed it.
- Label
nametext - What the address is, such as Home or Work.
- Street
streettext - Street and number.
- City
citytext - City or town.
- State or province
provincetext - State, province or region.
- Postal code
postal_codetext - Postal or ZIP code.
- Country
countrytext - The country's English name, such as France, or its two-letter code, such as FR.
Outputs
citytext- City
contact_idnumber- The number of the contact it belongs to
contact_nametext- That contact's name
countrytext- Country name
country_codetext- The country's two-letter code, such as US
idnumber- The address's number, which other Monica steps take
nametext- What the address is, such as Home
postal_codetext- Postal code
provincetext- State or province
streettext- Street
texttext- The address on one line
Example output
{
"city": "London",
"contact_id": 12,
"contact_name": "Ada Lovelace",
"country": "United Kingdom",
"country_code": "GB",
"id": 4,
"name": "Home",
"postal_code": "SW1Y 4JH",
"province": "",
"street": "12 St James's Square",
"text": "12 St James's Square, London, SW1Y 4JH, United Kingdom"
}Update contact
Change a contact's name, nickname, gender, date of birth or description, or mark them as deceased. Anything left blank stays as it is.
Inputs
- Contact
contacttextRequired - The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- First name
first_nametext - The contact's first name, such as Ada. Leave blank to keep it.
- Last name
last_nametext - The contact's last name. Leave blank to keep it.
- Nickname
nicknametext - What they go by. Leave blank to keep it.
- Gender
gendertext - The contact's gender, such as Woman.
- Date of birth
birthdatedate - The day they were born. Leave blank to keep it.
- Remind me of the birthday
birthday_remindertext - Whether Monica keeps a yearly reminder of the birthday.One of:
keep(Leave as it is),yes,no. Default:keep. - Description
descriptiontext - A short line shown under the contact's name, up to 255 characters. Leave blank to keep it.
- Deceased
deceasedtext - Whether the contact has died.One of:
keep(Leave as it is),yes,no. Default:keep.
Outputs
agenumber- Age in years, empty when the year of birth is unknown
birthdatetext- Date of birth (YYYY-MM-DD), blank when unknown or only the age or the day is known
birthdaytext- The birthday's month and day (MM-DD), blank when unknown
companytext- Where they work
created_attext- When the contact was added
descriptiontext- The short description under the contact's name
first_met_ontext- When you first met (YYYY-MM-DD), blank when unknown
first_nametext- First name
food_preferencestext- What they like or can't eat
gendertext- Gender, such as Woman
how_you_mettext- How you met
idnumber- The contact's number, which other Monica steps take
is_deceasedtrue/false- Whether the contact has died
is_starredtrue/false- Whether the contact is a favorite
jobtext- Job title
last_activity_ontext- When you last did something together (YYYY-MM-DD), blank when never
last_called_ontext- When you last called (YYYY-MM-DD), blank when never
last_nametext- Last name
linktext- Where the contact opens in Monica
nametext- The contact's full name as Monica shows it
nicknametext- Nickname
tagslist- The names of the contact's tags
updated_attext- When the contact last changed
Example output
{
"age": 35,
"birthdate": "1990-12-10",
"birthday": "12-10",
"company": "Analytical Engines Ltd",
"created_at": "2026-01-05T09:30:00Z",
"description": "Met at the maths society",
"first_met_on": "2015-06-05",
"first_name": "Ada",
"food_preferences": "Vegetarian",
"gender": "Woman",
"how_you_met": "At a lecture",
"id": 12,
"is_deceased": false,
"is_starred": false,
"job": "Analyst",
"last_activity_on": "2026-10-20",
"last_called_on": "2026-11-02",
"last_name": "Lovelace",
"link": "https://app.monicahq.com/people/h:4G7r3K91nkYn2LWe5m",
"name": "Ada Lovelace",
"nickname": "",
"tags": [
"friend"
],
"updated_at": "2026-11-02T18:00:00Z"
}Update contact field
Change an email address, phone number or handle a contact has, or what type it is.
Inputs
- Contact field
contact_fieldtextRequired - The contact field's number, from the Monica step that added or listed it.
- Value
valuetext - The new address, number or handle. Leave blank to keep it.
- Type
field_typetext - What it is, such as Email. Leave blank to keep it.
Outputs
contact_idnumber- The number of the contact it belongs to
contact_nametext- That contact's name
idnumber- The contact field's number, which other Monica steps take
typetext- What it is, such as Email, Phone or Twitter
type_idnumber- That type's number
valuetext- The address, number or handle
Example output
{
"contact_id": 12,
"contact_name": "Ada Lovelace",
"id": 31,
"type": "Email",
"type_id": 1,
"value": "ada@example.com"
}Update note
Rewrite a note or change whether it's starred.
Inputs
- Note
notetextRequired - The note's number, from the Monica step that added or listed it.
- Note
bodytext - The new text. Leave blank to keep it.
- Favorite
favoritetext - Whether the note is starred.One of:
keep(Leave as it is),yes,no. Default:keep.
Outputs
bodytext- The note's text
contact_idnumber- The number of the contact it belongs to
contact_nametext- That contact's name
created_attext- When the note was written
idnumber- The note's number, which other Monica steps take
is_favoritetrue/false- Whether the note is starred
updated_attext- When the note last changed
Example output
{
"body": "Starting a new job in January.",
"contact_id": 12,
"contact_name": "Ada Lovelace",
"created_at": "2026-11-02T18:00:00Z",
"id": 21,
"is_favorite": false,
"updated_at": "2026-11-02T18:00:00Z"
}Update reminder
Change a reminder's title, day, how often it repeats or its description. Anything left blank stays as it is.
Inputs
- Reminder
remindertextRequired - The reminder's number, from the Monica step that added or listed it.
- Title
titletext - What to be reminded of, such as Call about the house move. Leave blank to keep it.
- Date
remind_ondate - The day to be reminded, and the first one when it repeats. Leave blank to keep it.
- Repeats
repeatstext - How often it comes back.One of:
keep(Leave as it is),one_time(Once),week(Weekly),month(Monthly),year(Yearly). Default:keep. - Every
everynumber - How many weeks, months or years between repeats, such as 2 for every second week. Leave blank to keep it.From 1 to 100.
- Description
descriptiontext - More about it. Leave blank to keep it.
Outputs
contact_idnumber- The number of the contact it belongs to
contact_nametext- That contact's name
created_attext- When the reminder was made
datetext- The day it's first for (YYYY-MM-DD)
days_untilnumber- Days until then, 0 for today, empty when passed
descriptiontext- More about it
everynumber- How many weeks, months or years between repeats
idnumber- The reminder's number, which other Monica steps take
is_birthdaytrue/false- Whether Monica made it for a birthday
next_datetext- The next day it's due (YYYY-MM-DD), blank when it was for one day that has passed
repeatstext- one_time, week, month or year
titletext- What to be reminded of
Example output
{
"contact_id": 12,
"contact_name": "Ada Lovelace",
"created_at": "2026-01-05T09:30:00Z",
"date": "1990-12-10",
"days_until": 23,
"description": "",
"every": 1,
"id": 14,
"is_birthday": true,
"next_date": "2026-12-10",
"repeats": "year",
"title": "Wish happy birthday to Ada"
}