# Monica

> 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.

App · 57 actions. Web page: https://docs.lodol.com/docs/integrations/monica

## Actions

### Add address

Add an address to a contact, such as their home or work.

**Inputs**

- Contact (`contact`, text, required): The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Label (`name`, text): What the address is, such as Home or Work.
- Street (`street`, text): Street and number.
- City (`city`, text): City or town.
- State or province (`province`, text): State, province or region.
- Postal code (`postal_code`, text): Postal or ZIP code.
- Country (`country`, text): The country's English name, such as France, or its two-letter code, such as FR.

**Outputs**

- `city` (text): City
- `contact_id` (number): The number of the contact it belongs to
- `contact_name` (text): That contact's name
- `country` (text): Country name
- `country_code` (text): The country's two-letter code, such as US
- `id` (number): The address's number, which other Monica steps take
- `name` (text): What the address is, such as Home
- `postal_code` (text): Postal code
- `province` (text): State or province
- `street` (text): Street
- `text` (text): The address on one line

**Example output**

```json
{
  "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 (`contact`, text, required): The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Type (`field_type`, text, required): What it is, such as Email, Phone or Twitter.
- Value (`value`, text, required): The address, number or handle, such as ada@example.com.

**Outputs**

- `contact_id` (number): The number of the contact it belongs to
- `contact_name` (text): That contact's name
- `id` (number): The contact field's number, which other Monica steps take
- `type` (text): What it is, such as Email, Phone or Twitter
- `type_id` (number): That type's number
- `value` (text): The address, number or handle

**Example output**

```json
{
  "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 (`contact`, text, required): The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Amount (`amount`, number, required): How much, in the account's currency. From 0 to 1000000000.
- Who owes (`direction`, text): Who owes whom. Defaults to they owe you. One of: `they_owe` (They owe you), `i_owe` (You owe them). Default: `they_owe`.
- Reason (`reason`, text): What it's for.

**Outputs**

- `amount` (number): How much
- `amount_text` (text): The amount with its currency, such as $50.00
- `contact_id` (number): The number of the contact it belongs to
- `contact_name` (text): That contact's name
- `created_at` (text): When the debt was noted
- `direction` (text): i_owe (you owe the contact) or they_owe (they owe you)
- `id` (number): The debt's number, which other Monica steps take
- `reason` (text): What it's for
- `settled` (true/false): Whether it has been paid back

**Example output**

```json
{
  "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 (`contact`, text, required): The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Gift (`name`, text, required): What the gift is.
- Status (`status`, text): 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 (`comment`, text): A note about it.
- Link (`url`, text): A link to it, such as a shop page.
- Price (`amount`, number): What it costs, in the account's currency. From 0 to 1000000000.
- Date (`given_on`, date): The day it was given.

**Outputs**

- `amount` (number): What it costs, empty when not given
- `amount_text` (text): The cost with its currency, such as $20.00
- `comment` (text): A note about it
- `contact_id` (number): The number of the contact it belongs to
- `contact_name` (text): That contact's name
- `created_at` (text): When the gift was noted
- `date` (text): The day it was given (YYYY-MM-DD), blank when not given
- `id` (number): The gift's number, which other Monica steps take
- `name` (text): What the gift is
- `status` (text): idea, offered (you gave it) or received (they gave it)
- `url` (text): A link to it, such as a shop page

**Example output**

```json
{
  "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 (`title`, text, required): The entry's title.
- Entry (`post`, text, required): What to write.

**Outputs**

- `created_at` (text): When the entry was written
- `date` (text): The day it's for (YYYY-MM-DD)
- `id` (number): The entry's number, which other Monica steps take
- `post` (text): What was written
- `title` (text): The entry's title

**Example output**

```json
{
  "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 (`contact`, text, required): The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Note (`body`, text, required): The note's text.
- Favorite (`favorite`, true/false): Star the note so it stands out. Default: `false`.

**Outputs**

- `body` (text): The note's text
- `contact_id` (number): The number of the contact it belongs to
- `contact_name` (text): That contact's name
- `created_at` (text): When the note was written
- `id` (number): The note's number, which other Monica steps take
- `is_favorite` (true/false): Whether the note is starred
- `updated_at` (text): When the note last changed

**Example output**

```json
{
  "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 (`contact`, text, required): The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Tags (`tags`, text, required): The tags' names, separated by commas.

**Outputs**

- `age` (number): Age in years, empty when the year of birth is unknown
- `birthdate` (text): Date of birth (YYYY-MM-DD), blank when unknown or only the age or the day is known
- `birthday` (text): The birthday's month and day (MM-DD), blank when unknown
- `company` (text): Where they work
- `created_at` (text): When the contact was added
- `description` (text): The short description under the contact's name
- `first_met_on` (text): When you first met (YYYY-MM-DD), blank when unknown
- `first_name` (text): First name
- `food_preferences` (text): What they like or can't eat
- `gender` (text): Gender, such as Woman
- `how_you_met` (text): How you met
- `id` (number): The contact's number, which other Monica steps take
- `is_deceased` (true/false): Whether the contact has died
- `is_starred` (true/false): Whether the contact is a favorite
- `job` (text): Job title
- `last_activity_on` (text): When you last did something together (YYYY-MM-DD), blank when never
- `last_called_on` (text): When you last called (YYYY-MM-DD), blank when never
- `last_name` (text): Last name
- `link` (text): Where the contact opens in Monica
- `name` (text): The contact's full name as Monica shows it
- `nickname` (text): Nickname
- `tags` (list): The names of the contact's tags
- `updated_at` (text): When the contact last changed

**Example output**

```json
{
  "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 (`task`, text, required): The task's number, from the Monica step that added or listed it.

**Outputs**

- `completed` (true/false): Whether it's done
- `completed_at` (text): When it was done, blank when it isn't
- `contact_id` (number): The number of the contact it belongs to
- `contact_name` (text): That contact's name
- `created_at` (text): When the task was added
- `description` (text): More about it
- `id` (number): The task's number, which other Monica steps take
- `title` (text): What there is to do

**Example output**

```json
{
  "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_name`, text, required): The contact's first name, such as Ada.
- Last name (`last_name`, text): The contact's last name.
- Nickname (`nickname`, text): What they go by.
- Gender (`gender`, text): The contact's gender, such as Woman.
- Date of birth (`birthdate`, date): The day they were born.
- Remind me of the birthday (`birthday_reminder`, true/false): Have Monica keep a yearly reminder of the birthday. Needs a date of birth. Default: `false`.
- Description (`description`, text): A short line shown under the contact's name, up to 255 characters.
- Deceased (`is_deceased`, true/false): Whether the contact has died. Default: `false`.

**Outputs**

- `age` (number): Age in years, empty when the year of birth is unknown
- `birthdate` (text): Date of birth (YYYY-MM-DD), blank when unknown or only the age or the day is known
- `birthday` (text): The birthday's month and day (MM-DD), blank when unknown
- `company` (text): Where they work
- `created_at` (text): When the contact was added
- `description` (text): The short description under the contact's name
- `first_met_on` (text): When you first met (YYYY-MM-DD), blank when unknown
- `first_name` (text): First name
- `food_preferences` (text): What they like or can't eat
- `gender` (text): Gender, such as Woman
- `how_you_met` (text): How you met
- `id` (number): The contact's number, which other Monica steps take
- `is_deceased` (true/false): Whether the contact has died
- `is_starred` (true/false): Whether the contact is a favorite
- `job` (text): Job title
- `last_activity_on` (text): When you last did something together (YYYY-MM-DD), blank when never
- `last_called_on` (text): When you last called (YYYY-MM-DD), blank when never
- `last_name` (text): Last name
- `link` (text): Where the contact opens in Monica
- `name` (text): The contact's full name as Monica shows it
- `nickname` (text): Nickname
- `tags` (list): The names of the contact's tags
- `updated_at` (text): When the contact last changed

**Example output**

```json
{
  "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 (`contact`, text, required): The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Relationship (`relationship_type`, text, required): What the other person is to the contact, such as partner, child or friend.
- Other contact (`other_contact`, text, required): The other person: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.

**Outputs**

- `contact_id` (number): The number of the contact it belongs to
- `contact_name` (text): That contact's name
- `id` (number): The relationship's number, which other Monica steps take
- `other_contact_id` (number): The other person's number
- `other_contact_name` (text): The other person's name
- `relationship` (text): What the other person is to the contact, such as child
- `relationship_type_id` (number): That kind of relationship's number

**Example output**

```json
{
  "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 (`contact`, text, required): The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Title (`title`, text, required): What to be reminded of, such as Call about the house move.
- Date (`remind_on`, date, required): The day to be reminded, and the first one when it repeats.
- Repeats (`repeats`, text): How often it comes back. Defaults to once. One of: `one_time` (Once), `week` (Weekly), `month` (Monthly), `year` (Yearly). Default: `one_time`.
- Every (`every`, number): How many weeks, months or years between repeats, such as 2 for every second week. Defaults to 1. From 1 to 100.
- Description (`description`, text): More about it.

**Outputs**

- `contact_id` (number): The number of the contact it belongs to
- `contact_name` (text): That contact's name
- `created_at` (text): When the reminder was made
- `date` (text): The day it's first for (YYYY-MM-DD)
- `days_until` (number): Days until then, 0 for today, empty when passed
- `description` (text): More about it
- `every` (number): How many weeks, months or years between repeats
- `id` (number): The reminder's number, which other Monica steps take
- `is_birthday` (true/false): Whether Monica made it for a birthday
- `next_date` (text): The next day it's due (YYYY-MM-DD), blank when it was for one day that has passed
- `repeats` (text): one_time, week, month or year
- `title` (text): What to be reminded of

**Example output**

```json
{
  "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 (`title`, text, required): What there is to do.
- Contact (`contact`, text): The contact it's about. Leave blank for a task of your own.
- Description (`description`, text): More about it.

**Outputs**

- `completed` (true/false): Whether it's done
- `completed_at` (text): When it was done, blank when it isn't
- `contact_id` (number): The number of the contact it belongs to
- `contact_name` (text): That contact's name
- `created_at` (text): When the task was added
- `description` (text): More about it
- `id` (number): The task's number, which other Monica steps take
- `title` (text): What there is to do

**Example output**

```json
{
  "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 (`activity`, text, required): The activity's number, from the Monica step that added or listed it.

**Outputs**

- `deleted` (true/false): Whether Monica deleted it
- `id` (number): The number of what was deleted

**Example output**

```json
{
  "deleted": true,
  "id": 7
}
```

### Delete address

Remove an address from a contact.

**Inputs**

- Address (`address`, text, required): The address's number, from the Monica step that added or listed it.

**Outputs**

- `deleted` (true/false): Whether Monica deleted it
- `id` (number): The number of what was deleted

**Example output**

```json
{
  "deleted": true,
  "id": 7
}
```

### Delete call

Delete a logged call.

**Inputs**

- Call (`call`, text, required): The call's number, from the Monica step that added or listed it.

**Outputs**

- `deleted` (true/false): Whether Monica deleted it
- `id` (number): The number of what was deleted

**Example output**

```json
{
  "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 (`contact`, text, required): The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.

**Outputs**

- `deleted` (true/false): Whether Monica deleted it
- `id` (number): The number of what was deleted

**Example output**

```json
{
  "deleted": true,
  "id": 7
}
```

### Delete contact field

Remove an email address, phone number or handle from a contact.

**Inputs**

- Contact field (`contact_field`, text, required): The contact field's number, from the Monica step that added or listed it.

**Outputs**

- `deleted` (true/false): Whether Monica deleted it
- `id` (number): The number of what was deleted

**Example output**

```json
{
  "deleted": true,
  "id": 7
}
```

### Delete debt

Delete a debt.

**Inputs**

- Debt (`debt`, text, required): The debt's number, from the Monica step that added or listed it.

**Outputs**

- `deleted` (true/false): Whether Monica deleted it
- `id` (number): The number of what was deleted

**Example output**

```json
{
  "deleted": true,
  "id": 7
}
```

### Delete gift

Delete a gift.

**Inputs**

- Gift (`gift`, text, required): The gift's number, from the Monica step that added or listed it.

**Outputs**

- `deleted` (true/false): Whether Monica deleted it
- `id` (number): The number of what was deleted

**Example output**

```json
{
  "deleted": true,
  "id": 7
}
```

### Delete journal entry

Delete a journal entry.

**Inputs**

- Journal entry (`entry`, text, required): The journal entry's number, from the Monica step that added or listed it.

**Outputs**

- `deleted` (true/false): Whether Monica deleted it
- `id` (number): The number of what was deleted

**Example output**

```json
{
  "deleted": true,
  "id": 7
}
```

### Delete note

Delete a note.

**Inputs**

- Note (`note`, text, required): The note's number, from the Monica step that added or listed it.

**Outputs**

- `deleted` (true/false): Whether Monica deleted it
- `id` (number): The number of what was deleted

**Example output**

```json
{
  "deleted": true,
  "id": 7
}
```

### Delete relationship

Remove the link between two contacts, in both directions.

**Inputs**

- Relationship (`relationship`, text, required): The relationship's number, from the Monica step that added or listed it.

**Outputs**

- `deleted` (true/false): Whether Monica deleted it
- `id` (number): The number of what was deleted

**Example output**

```json
{
  "deleted": true,
  "id": 7
}
```

### Delete reminder

Delete a reminder.

**Inputs**

- Reminder (`reminder`, text, required): The reminder's number, from the Monica step that added or listed it.

**Outputs**

- `deleted` (true/false): Whether Monica deleted it
- `id` (number): The number of what was deleted

**Example output**

```json
{
  "deleted": true,
  "id": 7
}
```

### Delete tag

Delete a tag from the account, taking it off every contact that has it.

**Inputs**

- Tag (`tag`, text, required): The tag's name, or its number from 'List tags'.

**Outputs**

- `deleted` (true/false): Whether Monica deleted it
- `id` (number): The number of what was deleted

**Example output**

```json
{
  "deleted": true,
  "id": 7
}
```

### Delete task

Delete a task.

**Inputs**

- Task (`task`, text, required): The task's number, from the Monica step that added or listed it.

**Outputs**

- `deleted` (true/false): Whether Monica deleted it
- `id` (number): The number of what was deleted

**Example output**

```json
{
  "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 (`query`, text): Words to look for, such as a name or an email address. Leave blank for every contact.
- Order (`order`, text): Which contacts come first. Defaults to the newest. One of: `newest` (Newest first), `updated` (Recently changed first), `oldest` (Oldest first). Default: `newest`.
- Limit (`limit`, number): The most to return, newest first. Defaults to 50. From 1 to 500.

**Outputs**

- `contacts` (list): Each contact found
- `count` (number): How many are listed

**Example output**

```json
{
  "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 (`contact`, text, required): The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.

**Outputs**

- `activities_count` (number): How many activities you've logged together
- `addresses` (list): The contact's addresses
- `age` (number): Age in years, empty when the year of birth is unknown
- `birthdate` (text): Date of birth (YYYY-MM-DD), blank when unknown or only the age or the day is known
- `birthday` (text): The birthday's month and day (MM-DD), blank when unknown
- `calls_count` (number): How many calls you've logged
- `company` (text): Where they work
- `contact_fields` (list): Every way to reach the contact: emails, phones and social handles
- `created_at` (text): When the contact was added
- `description` (text): The short description under the contact's name
- `emails` (list): The contact's email addresses
- `first_met_on` (text): When you first met (YYYY-MM-DD), blank when unknown
- `first_name` (text): First name
- `food_preferences` (text): What they like or can't eat
- `gender` (text): Gender, such as Woman
- `gifts_count` (number): How many gifts are noted for the contact
- `how_you_met` (text): How you met
- `id` (number): The contact's number, which other Monica steps take
- `is_deceased` (true/false): Whether the contact has died
- `is_starred` (true/false): Whether the contact is a favorite
- `job` (text): Job title
- `last_activity_on` (text): When you last did something together (YYYY-MM-DD), blank when never
- `last_called_on` (text): When you last called (YYYY-MM-DD), blank when never
- `last_name` (text): Last name
- `link` (text): Where the contact opens in Monica
- `name` (text): The contact's full name as Monica shows it
- `nickname` (text): Nickname
- `notes_count` (number): How many notes the contact has
- `phones` (list): The contact's phone numbers
- `reminders_count` (number): How many reminders the contact has
- `tags` (list): The names of the contact's tags
- `tasks_count` (number): How many tasks the contact has
- `updated_at` (text): When the contact last changed

**Example output**

```json
{
  "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 (`contact`, text): Only this contact's. Leave blank for everyone's.
- Limit (`limit`, number): The most to return, newest first. Defaults to 50. From 1 to 500.

**Outputs**

- `activities` (list): Each activity, newest first
- `count` (number): How many are listed

**Example output**

```json
{
  "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_types` (list): Each kind of activity the account offers
- `count` (number): How many are listed

**Example output**

```json
{
  "activity_types": [
    {
      "category": "Food",
      "id": 5,
      "name": "ate at a restaurant"
    }
  ],
  "count": 1
}
```

### List addresses

List a contact's addresses.

**Inputs**

- Contact (`contact`, text, required): The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.

**Outputs**

- `addresses` (list): Each address
- `count` (number): How many are listed

**Example output**

```json
{
  "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 (`contact`, text): Only this contact's. Leave blank for everyone's.
- Limit (`limit`, number): The most to return, newest first. Defaults to 50. From 1 to 500.

**Outputs**

- `calls` (list): Each call, newest first
- `count` (number): How many are listed

**Example output**

```json
{
  "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_types` (list): Each kind of contact detail the account offers
- `count` (number): How many are listed

**Example output**

```json
{
  "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 (`contact`, text, required): The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.

**Outputs**

- `contact_fields` (list): Each email, phone number or handle
- `count` (number): How many are listed

**Example output**

```json
{
  "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 (`contact`, text): Only this contact's. Leave blank for everyone's.
- Limit (`limit`, number): The most to return, newest first. Defaults to 50. From 1 to 500.

**Outputs**

- `count` (number): How many are listed
- `debts` (list): Each debt, newest first

**Example output**

```json
{
  "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**

- `count` (number): How many are listed
- `genders` (list): Each gender the account offers

**Example output**

```json
{
  "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 (`contact`, text): Only this contact's. Leave blank for everyone's.
- Limit (`limit`, number): The most to return, newest first. Defaults to 50. From 1 to 500.

**Outputs**

- `count` (number): How many are listed
- `gifts` (list): Each gift, newest first

**Example output**

```json
{
  "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 (`limit`, number): The most to return, newest first. Defaults to 50. From 1 to 500.

**Outputs**

- `count` (number): How many are listed
- `entries` (list): Each journal entry, newest first

**Example output**

```json
{
  "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 (`contact`, text): Only this contact's. Leave blank for everyone's.
- Limit (`limit`, number): The most to return, newest first. Defaults to 50. From 1 to 500.

**Outputs**

- `count` (number): How many are listed
- `notes` (list): Each note, newest first

**Example output**

```json
{
  "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**

- `count` (number): How many are listed
- `relationship_types` (list): Each kind of relationship the account offers

**Example output**

```json
{
  "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 (`contact`, text, required): The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.

**Outputs**

- `count` (number): How many are listed
- `relationships` (list): Each person the contact is related to

**Example output**

```json
{
  "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 (`contact`, text): Only this contact's. Leave blank for everyone's.
- Limit (`limit`, number): The most to return, newest first. Defaults to 50. From 1 to 500.

**Outputs**

- `count` (number): How many are listed
- `reminders` (list): Each reminder

**Example output**

```json
{
  "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**

- `count` (number): How many are listed
- `tags` (list): Each tag in the account

**Example output**

```json
{
  "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 (`contact`, text): Only this contact's. Leave blank for everyone's.
- Status (`status`, text): Which tasks to list. Defaults to those not done. One of: `open` (Not done), `done`, `all`. Default: `open`.
- Limit (`limit`, number): The most to return, newest first. Defaults to 50. From 1 to 500.

**Outputs**

- `count` (number): How many are listed
- `tasks` (list): Each task, newest first

**Example output**

```json
{
  "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 (`days`, number): How many days ahead to look: 0 for today only. Defaults to 30. From 0 to 366.

**Outputs**

- `count` (number): How many are listed
- `reminders` (list): Each reminder

**Example output**

```json
{
  "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 (`summary`, text, required): What you did, in a few words, such as Dinner at Luigi's.
- Contacts (`contacts`, text, required): Who took part: contacts' numbers or names, separated by commas.
- Date (`happened_on`, date): The day it happened. Defaults to today.
- Activity type (`activity_type`, text): The kind of activity, such as ate at a restaurant.
- Description (`description`, text): More about it: what you talked about, how it went.

**Outputs**

- `activity_type` (text): The kind of activity, blank when none was chosen
- `contact_names` (text): Their names, separated by commas
- `contacts` (list): The contacts who took part
- `created_at` (text): When the activity was logged
- `description` (text): More about it
- `happened_on` (text): The day it happened (YYYY-MM-DD)
- `id` (number): The activity's number, which other Monica steps take
- `summary` (text): What you did, in a few words

**Example output**

```json
{
  "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 (`contact`, text, required): The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Date (`called_on`, date): The day of the call. Defaults to today.
- What was said (`content`, text): Notes on the call.
- Who called (`who_called`, text): Who made the call. Defaults to you. One of: `me` (You called), `contact` (They called). Default: `me`.

**Outputs**

- `called_on` (text): The day of the call (YYYY-MM-DD)
- `contact_id` (number): The number of the contact it belongs to
- `contact_name` (text): That contact's name
- `content` (text): What was said
- `created_at` (text): When the call was logged
- `id` (number): The call's number, which other Monica steps take
- `who_called` (text): me or contact: who made the call

**Example output**

```json
{
  "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 (`contact`, text, required): The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Tags (`tags`, text, required): The tags' names, separated by commas.

**Outputs**

- `age` (number): Age in years, empty when the year of birth is unknown
- `birthdate` (text): Date of birth (YYYY-MM-DD), blank when unknown or only the age or the day is known
- `birthday` (text): The birthday's month and day (MM-DD), blank when unknown
- `company` (text): Where they work
- `created_at` (text): When the contact was added
- `description` (text): The short description under the contact's name
- `first_met_on` (text): When you first met (YYYY-MM-DD), blank when unknown
- `first_name` (text): First name
- `food_preferences` (text): What they like or can't eat
- `gender` (text): Gender, such as Woman
- `how_you_met` (text): How you met
- `id` (number): The contact's number, which other Monica steps take
- `is_deceased` (true/false): Whether the contact has died
- `is_starred` (true/false): Whether the contact is a favorite
- `job` (text): Job title
- `last_activity_on` (text): When you last did something together (YYYY-MM-DD), blank when never
- `last_called_on` (text): When you last called (YYYY-MM-DD), blank when never
- `last_name` (text): Last name
- `link` (text): Where the contact opens in Monica
- `name` (text): The contact's full name as Monica shows it
- `nickname` (text): Nickname
- `tags` (list): The names of the contact's tags
- `updated_at` (text): When the contact last changed

**Example output**

```json
{
  "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 (`contact`, text, required): The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Job title (`job`, text): What they do, such as Architect.
- Company (`company`, text): Where they work.

**Outputs**

- `age` (number): Age in years, empty when the year of birth is unknown
- `birthdate` (text): Date of birth (YYYY-MM-DD), blank when unknown or only the age or the day is known
- `birthday` (text): The birthday's month and day (MM-DD), blank when unknown
- `company` (text): Where they work
- `created_at` (text): When the contact was added
- `description` (text): The short description under the contact's name
- `first_met_on` (text): When you first met (YYYY-MM-DD), blank when unknown
- `first_name` (text): First name
- `food_preferences` (text): What they like or can't eat
- `gender` (text): Gender, such as Woman
- `how_you_met` (text): How you met
- `id` (number): The contact's number, which other Monica steps take
- `is_deceased` (true/false): Whether the contact has died
- `is_starred` (true/false): Whether the contact is a favorite
- `job` (text): Job title
- `last_activity_on` (text): When you last did something together (YYYY-MM-DD), blank when never
- `last_called_on` (text): When you last called (YYYY-MM-DD), blank when never
- `last_name` (text): Last name
- `link` (text): Where the contact opens in Monica
- `name` (text): The contact's full name as Monica shows it
- `nickname` (text): Nickname
- `tags` (list): The names of the contact's tags
- `updated_at` (text): When the contact last changed

**Example output**

```json
{
  "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 (`contact`, text, required): The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- Food preferences (`food_preferences`, text, required): What they like or can't eat.

**Outputs**

- `age` (number): Age in years, empty when the year of birth is unknown
- `birthdate` (text): Date of birth (YYYY-MM-DD), blank when unknown or only the age or the day is known
- `birthday` (text): The birthday's month and day (MM-DD), blank when unknown
- `company` (text): Where they work
- `created_at` (text): When the contact was added
- `description` (text): The short description under the contact's name
- `first_met_on` (text): When you first met (YYYY-MM-DD), blank when unknown
- `first_name` (text): First name
- `food_preferences` (text): What they like or can't eat
- `gender` (text): Gender, such as Woman
- `how_you_met` (text): How you met
- `id` (number): The contact's number, which other Monica steps take
- `is_deceased` (true/false): Whether the contact has died
- `is_starred` (true/false): Whether the contact is a favorite
- `job` (text): Job title
- `last_activity_on` (text): When you last did something together (YYYY-MM-DD), blank when never
- `last_called_on` (text): When you last called (YYYY-MM-DD), blank when never
- `last_name` (text): Last name
- `link` (text): Where the contact opens in Monica
- `name` (text): The contact's full name as Monica shows it
- `nickname` (text): Nickname
- `tags` (list): The names of the contact's tags
- `updated_at` (text): When the contact last changed

**Example output**

```json
{
  "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 (`contact`, text, required): 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_met`, text): The story, such as At Sam's wedding.
- Date you met (`met_on`, date): The day you first met.

**Outputs**

- `age` (number): Age in years, empty when the year of birth is unknown
- `birthdate` (text): Date of birth (YYYY-MM-DD), blank when unknown or only the age or the day is known
- `birthday` (text): The birthday's month and day (MM-DD), blank when unknown
- `company` (text): Where they work
- `created_at` (text): When the contact was added
- `description` (text): The short description under the contact's name
- `first_met_on` (text): When you first met (YYYY-MM-DD), blank when unknown
- `first_name` (text): First name
- `food_preferences` (text): What they like or can't eat
- `gender` (text): Gender, such as Woman
- `how_you_met` (text): How you met
- `id` (number): The contact's number, which other Monica steps take
- `is_deceased` (true/false): Whether the contact has died
- `is_starred` (true/false): Whether the contact is a favorite
- `job` (text): Job title
- `last_activity_on` (text): When you last did something together (YYYY-MM-DD), blank when never
- `last_called_on` (text): When you last called (YYYY-MM-DD), blank when never
- `last_name` (text): Last name
- `link` (text): Where the contact opens in Monica
- `name` (text): The contact's full name as Monica shows it
- `nickname` (text): Nickname
- `tags` (list): The names of the contact's tags
- `updated_at` (text): When the contact last changed

**Example output**

```json
{
  "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 (`debt`, text, required): The debt's number, from the Monica step that added or listed it.

**Outputs**

- `amount` (number): How much
- `amount_text` (text): The amount with its currency, such as $50.00
- `contact_id` (number): The number of the contact it belongs to
- `contact_name` (text): That contact's name
- `created_at` (text): When the debt was noted
- `direction` (text): i_owe (you owe the contact) or they_owe (they owe you)
- `id` (number): The debt's number, which other Monica steps take
- `reason` (text): What it's for
- `settled` (true/false): Whether it has been paid back

**Example output**

```json
{
  "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 (`activity`, text, required): The activity's number, from the Monica step that added or listed it.
- Summary (`summary`, text): What you did, in a few words, such as Dinner at Luigi's. Leave blank to keep it.
- Contacts (`contacts`, text): Who took part: contacts' numbers or names, separated by commas. Leave blank to keep them.
- Date (`happened_on`, date): The day it happened. Leave blank to keep it.
- Activity type (`activity_type`, text): The kind of activity, such as ate at a restaurant. Leave blank to keep it.
- Description (`description`, text): More about it: what you talked about, how it went. Leave blank to keep it.

**Outputs**

- `activity_type` (text): The kind of activity, blank when none was chosen
- `contact_names` (text): Their names, separated by commas
- `contacts` (list): The contacts who took part
- `created_at` (text): When the activity was logged
- `description` (text): More about it
- `happened_on` (text): The day it happened (YYYY-MM-DD)
- `id` (number): The activity's number, which other Monica steps take
- `summary` (text): What you did, in a few words

**Example output**

```json
{
  "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 (`address`, text, required): The address's number, from the Monica step that added or listed it.
- Label (`name`, text): What the address is, such as Home or Work.
- Street (`street`, text): Street and number.
- City (`city`, text): City or town.
- State or province (`province`, text): State, province or region.
- Postal code (`postal_code`, text): Postal or ZIP code.
- Country (`country`, text): The country's English name, such as France, or its two-letter code, such as FR.

**Outputs**

- `city` (text): City
- `contact_id` (number): The number of the contact it belongs to
- `contact_name` (text): That contact's name
- `country` (text): Country name
- `country_code` (text): The country's two-letter code, such as US
- `id` (number): The address's number, which other Monica steps take
- `name` (text): What the address is, such as Home
- `postal_code` (text): Postal code
- `province` (text): State or province
- `street` (text): Street
- `text` (text): The address on one line

**Example output**

```json
{
  "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 (`contact`, text, required): The contact: pick one, or give the contact's number from another Monica step or their name, such as Ada Lovelace.
- First name (`first_name`, text): The contact's first name, such as Ada. Leave blank to keep it.
- Last name (`last_name`, text): The contact's last name. Leave blank to keep it.
- Nickname (`nickname`, text): What they go by. Leave blank to keep it.
- Gender (`gender`, text): The contact's gender, such as Woman.
- Date of birth (`birthdate`, date): The day they were born. Leave blank to keep it.
- Remind me of the birthday (`birthday_reminder`, text): Whether Monica keeps a yearly reminder of the birthday. One of: `keep` (Leave as it is), `yes`, `no`. Default: `keep`.
- Description (`description`, text): A short line shown under the contact's name, up to 255 characters. Leave blank to keep it.
- Deceased (`deceased`, text): Whether the contact has died. One of: `keep` (Leave as it is), `yes`, `no`. Default: `keep`.

**Outputs**

- `age` (number): Age in years, empty when the year of birth is unknown
- `birthdate` (text): Date of birth (YYYY-MM-DD), blank when unknown or only the age or the day is known
- `birthday` (text): The birthday's month and day (MM-DD), blank when unknown
- `company` (text): Where they work
- `created_at` (text): When the contact was added
- `description` (text): The short description under the contact's name
- `first_met_on` (text): When you first met (YYYY-MM-DD), blank when unknown
- `first_name` (text): First name
- `food_preferences` (text): What they like or can't eat
- `gender` (text): Gender, such as Woman
- `how_you_met` (text): How you met
- `id` (number): The contact's number, which other Monica steps take
- `is_deceased` (true/false): Whether the contact has died
- `is_starred` (true/false): Whether the contact is a favorite
- `job` (text): Job title
- `last_activity_on` (text): When you last did something together (YYYY-MM-DD), blank when never
- `last_called_on` (text): When you last called (YYYY-MM-DD), blank when never
- `last_name` (text): Last name
- `link` (text): Where the contact opens in Monica
- `name` (text): The contact's full name as Monica shows it
- `nickname` (text): Nickname
- `tags` (list): The names of the contact's tags
- `updated_at` (text): When the contact last changed

**Example output**

```json
{
  "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_field`, text, required): The contact field's number, from the Monica step that added or listed it.
- Value (`value`, text): The new address, number or handle. Leave blank to keep it.
- Type (`field_type`, text): What it is, such as Email. Leave blank to keep it.

**Outputs**

- `contact_id` (number): The number of the contact it belongs to
- `contact_name` (text): That contact's name
- `id` (number): The contact field's number, which other Monica steps take
- `type` (text): What it is, such as Email, Phone or Twitter
- `type_id` (number): That type's number
- `value` (text): The address, number or handle

**Example output**

```json
{
  "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 (`note`, text, required): The note's number, from the Monica step that added or listed it.
- Note (`body`, text): The new text. Leave blank to keep it.
- Favorite (`favorite`, text): Whether the note is starred. One of: `keep` (Leave as it is), `yes`, `no`. Default: `keep`.

**Outputs**

- `body` (text): The note's text
- `contact_id` (number): The number of the contact it belongs to
- `contact_name` (text): That contact's name
- `created_at` (text): When the note was written
- `id` (number): The note's number, which other Monica steps take
- `is_favorite` (true/false): Whether the note is starred
- `updated_at` (text): When the note last changed

**Example output**

```json
{
  "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 (`reminder`, text, required): The reminder's number, from the Monica step that added or listed it.
- Title (`title`, text): What to be reminded of, such as Call about the house move. Leave blank to keep it.
- Date (`remind_on`, date): The day to be reminded, and the first one when it repeats. Leave blank to keep it.
- Repeats (`repeats`, text): How often it comes back. One of: `keep` (Leave as it is), `one_time` (Once), `week` (Weekly), `month` (Monthly), `year` (Yearly). Default: `keep`.
- Every (`every`, number): 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 (`description`, text): More about it. Leave blank to keep it.

**Outputs**

- `contact_id` (number): The number of the contact it belongs to
- `contact_name` (text): That contact's name
- `created_at` (text): When the reminder was made
- `date` (text): The day it's first for (YYYY-MM-DD)
- `days_until` (number): Days until then, 0 for today, empty when passed
- `description` (text): More about it
- `every` (number): How many weeks, months or years between repeats
- `id` (number): The reminder's number, which other Monica steps take
- `is_birthday` (true/false): Whether Monica made it for a birthday
- `next_date` (text): The next day it's due (YYYY-MM-DD), blank when it was for one day that has passed
- `repeats` (text): one_time, week, month or year
- `title` (text): What to be reminded of

**Example output**

```json
{
  "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"
}
```
