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

ActionWhat it does
Add addressAdd an address to a contact, such as their home or work.
Add contact fieldAdd an email address, phone number or social handle to a contact.
Add debtNote money a contact owes you, or you owe them.
Add giftNote a gift for a contact: an idea for later, one you gave or one they gave you.
Add journal entryWrite an entry in your Monica journal for today.
Add noteWrite a note about a contact, such as what they told you last time.
Add tags to contactPut one or more tags on a contact, such as family or book club.
Complete taskMark a task as done.
Create contactAdd a person to Monica, with their name, nickname, gender, date of birth and a short description.
Create relationshipLink two contacts, such as making one the partner, child or colleague of the other.
Create reminderHave Monica remind you of something about a contact, once or every so many weeks, months or years.
Create taskAdd a task, about a contact or on its own, such as Send the photos.
Delete activityDelete an activity.
Delete addressRemove an address from a contact.
Delete callDelete a logged call.
Delete contactDelete a contact with everything kept about them: notes, activities, reminders, tasks and gifts.
Delete contact fieldRemove an email address, phone number or handle from a contact.
Delete debtDelete a debt.
Delete giftDelete a gift.
Delete journal entryDelete a journal entry.
Delete noteDelete a note.
Delete relationshipRemove the link between two contacts, in both directions.
Delete reminderDelete a reminder.
Delete tagDelete a tag from the account, taking it off every contact that has it.
Delete taskDelete a task.
Find contactsFind contacts by words in their name, nickname, job, email or anything else Monica searches, or list them all, newest first.
Get contactGet a contact with their emails, phone numbers, addresses, tags, work, birthday and how many notes, activities and reminders they have.
List activitiesList what you've done with one contact or with everyone, newest first.
List activity typesList the kinds of activity the account offers, such as ate at a restaurant or went to the theater.
List addressesList a contact's addresses.
List callsList the phone calls logged with one contact or with everyone, newest first.
List contact field typesList the kinds of contact detail the account offers, such as Email, Phone, Twitter and LinkedIn.
List contact fieldsList a contact's emails, phone numbers and social handles.
List debtsList the debts between you and one contact or everyone, settled or not.
List gendersList the genders the account offers for a contact.
List giftsList the gifts noted for one contact or for everyone: ideas, given and received.
List journal entriesList your journal entries, newest first.
List notesList the notes kept about one contact or about everyone, newest first.
List relationship typesList the kinds of relationship the account offers, such as partner, child, friend and colleague.
List relationshipsList the people a contact is related to: partner, children, friends, colleagues.
List remindersList the reminders kept for one contact or for everyone, with the next day each is due.
List tagsList every tag in the account.
List tasksList the tasks to do for one contact or for everyone: those not done, those done, or all.
List upcoming remindersList the reminders due in the next days, birthdays among them, soonest first, such as for a weekly digest.
Log activityRecord something you did with one or more contacts, such as a dinner or a walk, with the day and what happened.
Log callRecord a phone call with a contact: the day, who called and what was said.
Remove tags from contactTake one or more tags off a contact.
Set contact's workSet a contact's job title, where they work, or both.
Set food preferencesWrite down what a contact likes or can't eat, such as vegetarian or allergic to nuts.
Set how you metWrite down how and when you met a contact.
Settle debtMark a debt as paid back.
Update activityChange an activity's summary, day, type, description or who took part.
Update addressChange parts of a contact's address.
Update contactChange a contact's name, nickname, gender, date of birth or description, or mark them as deceased.
Update contact fieldChange an email address, phone number or handle a contact has, or what type it is.
Update noteRewrite a note or change whether it's starred.
Update reminderChange 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

ContactcontacttextRequired
The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
Labelnametext
What the address is, such as Home or Work.
Streetstreettext
Street and number.
Citycitytext
City or town.
State or provinceprovincetext
State, province or region.
Postal codepostal_codetext
Postal or ZIP code.
Countrycountrytext
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

ContactcontacttextRequired
The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
Typefield_typetextRequired
What it is, such as Email, Phone or Twitter.
ValuevaluetextRequired
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

ContactcontacttextRequired
The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
AmountamountnumberRequired
How much, in the account's currency.From 0 to 1000000000.
Who owesdirectiontext
Who owes whom. Defaults to they owe you.One of: they_owe (They owe you), i_owe (You owe them). Default: they_owe.
Reasonreasontext
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

ContactcontacttextRequired
The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
GiftnametextRequired
What the gift is.
Statusstatustext
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.
Commentcommenttext
A note about it.
Linkurltext
A link to it, such as a shop page.
Priceamountnumber
What it costs, in the account's currency.From 0 to 1000000000.
Dategiven_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

TitletitletextRequired
The entry's title.
EntryposttextRequired
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

ContactcontacttextRequired
The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
NotebodytextRequired
The note's text.
Favoritefavoritetrue/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

ContactcontacttextRequired
The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
TagstagstextRequired
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

TasktasktextRequired
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 namefirst_nametextRequired
The contact's first name, such as Ada.
Last namelast_nametext
The contact's last name.
Nicknamenicknametext
What they go by.
Gendergendertext
The contact's gender, such as Woman.
Date of birthbirthdatedate
The day they were born.
Remind me of the birthdaybirthday_remindertrue/false
Have Monica keep a yearly reminder of the birthday. Needs a date of birth.Default: false.
Descriptiondescriptiontext
A short line shown under the contact's name, up to 255 characters.
Deceasedis_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

ContactcontacttextRequired
The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
Relationshiprelationship_typetextRequired
What the other person is to the contact, such as partner, child or friend.
Other contactother_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

ContactcontacttextRequired
The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
TitletitletextRequired
What to be reminded of, such as Call about the house move.
Dateremind_ondateRequired
The day to be reminded, and the first one when it repeats.
Repeatsrepeatstext
How often it comes back. Defaults to once.One of: one_time (Once), week (Weekly), month (Monthly), year (Yearly). Default: one_time.
Everyeverynumber
How many weeks, months or years between repeats, such as 2 for every second week. Defaults to 1.From 1 to 100.
Descriptiondescriptiontext
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

TitletitletextRequired
What there is to do.
Contactcontacttext
The contact it's about. Leave blank for a task of your own.
Descriptiondescriptiontext
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

ActivityactivitytextRequired
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

AddressaddresstextRequired
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

CallcalltextRequired
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

ContactcontacttextRequired
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 fieldcontact_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

DebtdebttextRequired
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

GiftgifttextRequired
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 entryentrytextRequired
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

NotenotetextRequired
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

RelationshiprelationshiptextRequired
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

ReminderremindertextRequired
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

TagtagtextRequired
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

TasktasktextRequired
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

Searchquerytext
Words to look for, such as a name or an email address. Leave blank for every contact.
Orderordertext
Which contacts come first. Defaults to the newest.One of: newest (Newest first), updated (Recently changed first), oldest (Oldest first). Default: newest.
Limitlimitnumber
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

ContactcontacttextRequired
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

Contactcontacttext
Only this contact's. Leave blank for everyone's.
Limitlimitnumber
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

ContactcontacttextRequired
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

Contactcontacttext
Only this contact's. Leave blank for everyone's.
Limitlimitnumber
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

ContactcontacttextRequired
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

Contactcontacttext
Only this contact's. Leave blank for everyone's.
Limitlimitnumber
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

Contactcontacttext
Only this contact's. Leave blank for everyone's.
Limitlimitnumber
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

Limitlimitnumber
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

Contactcontacttext
Only this contact's. Leave blank for everyone's.
Limitlimitnumber
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

ContactcontacttextRequired
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

Contactcontacttext
Only this contact's. Leave blank for everyone's.
Limitlimitnumber
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

Contactcontacttext
Only this contact's. Leave blank for everyone's.
Statusstatustext
Which tasks to list. Defaults to those not done.One of: open (Not done), done, all. Default: open.
Limitlimitnumber
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 aheaddaysnumber
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

SummarysummarytextRequired
What you did, in a few words, such as Dinner at Luigi's.
ContactscontactstextRequired
Who took part: contacts' numbers or names, separated by commas.
Datehappened_ondate
The day it happened. Defaults to today.
Activity typeactivity_typetext
The kind of activity, such as ate at a restaurant.
Descriptiondescriptiontext
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

ContactcontacttextRequired
The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
Datecalled_ondate
The day of the call. Defaults to today.
What was saidcontenttext
Notes on the call.
Who calledwho_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

ContactcontacttextRequired
The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
TagstagstextRequired
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

ContactcontacttextRequired
The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
Job titlejobtext
What they do, such as Architect.
Companycompanytext
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

ContactcontacttextRequired
The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
Food preferencesfood_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

ContactcontacttextRequired
The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
How you methow_you_mettext
The story, such as At Sam's wedding.
Date you metmet_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

DebtdebttextRequired
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

ActivityactivitytextRequired
The activity's number, from the Monica step that added or listed it.
Summarysummarytext
What you did, in a few words, such as Dinner at Luigi's. Leave blank to keep it.
Contactscontactstext
Who took part: contacts' numbers or names, separated by commas. Leave blank to keep them.
Datehappened_ondate
The day it happened. Leave blank to keep it.
Activity typeactivity_typetext
The kind of activity, such as ate at a restaurant. Leave blank to keep it.
Descriptiondescriptiontext
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

AddressaddresstextRequired
The address's number, from the Monica step that added or listed it.
Labelnametext
What the address is, such as Home or Work.
Streetstreettext
Street and number.
Citycitytext
City or town.
State or provinceprovincetext
State, province or region.
Postal codepostal_codetext
Postal or ZIP code.
Countrycountrytext
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

ContactcontacttextRequired
The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
First namefirst_nametext
The contact's first name, such as Ada. Leave blank to keep it.
Last namelast_nametext
The contact's last name. Leave blank to keep it.
Nicknamenicknametext
What they go by. Leave blank to keep it.
Gendergendertext
The contact's gender, such as Woman.
Date of birthbirthdatedate
The day they were born. Leave blank to keep it.
Remind me of the birthdaybirthday_remindertext
Whether Monica keeps a yearly reminder of the birthday.One of: keep (Leave as it is), yes, no. Default: keep.
Descriptiondescriptiontext
A short line shown under the contact's name, up to 255 characters. Leave blank to keep it.
Deceaseddeceasedtext
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 fieldcontact_fieldtextRequired
The contact field's number, from the Monica step that added or listed it.
Valuevaluetext
The new address, number or handle. Leave blank to keep it.
Typefield_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

NotenotetextRequired
The note's number, from the Monica step that added or listed it.
Notebodytext
The new text. Leave blank to keep it.
Favoritefavoritetext
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

ReminderremindertextRequired
The reminder's number, from the Monica step that added or listed it.
Titletitletext
What to be reminded of, such as Call about the house move. Leave blank to keep it.
Dateremind_ondate
The day to be reminded, and the first one when it repeats. Leave blank to keep it.
Repeatsrepeatstext
How often it comes back.One of: keep (Leave as it is), one_time (Once), week (Weekly), month (Monthly), year (Yearly). Default: keep.
Everyeverynumber
How many weeks, months or years between repeats, such as 2 for every second week. Leave blank to keep it.From 1 to 100.
Descriptiondescriptiontext
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"
}

On this page