# Twenty

> Keep Twenty, the open-source CRM, up to date: add and update people, companies and deals from forms and sign-ups, move deals through the pipeline, and add notes and tasks. Start a workflow when someone or something is added, or a deal changes stage.

App · 18 actions. Web page: https://docs.lodol.com/docs/integrations/twenty

## Actions

### Add note

Add a note to a person, a company or an opportunity, shown on its timeline. Give at least one.

**Inputs**

- Title (`title`, text, required): The note's title.
- Note (`body`, text): What the note says. Markdown, such as **bold** and lists, is kept.
- Person (`person`, text): The person's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Company (`company`, text): The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Opportunity (`opportunity`, text): The opportunity's ID, from another Twenty step or the trigger, or a link to it in Twenty.

**Outputs**

- `body` (text): What it says
- `created_at` (text): When it was added (ISO 8601)
- `id` (text): The note's ID
- `link` (text): A link to it in Twenty; empty if the server doesn't say its address
- `linked_to` (list): The IDs of the records it's on
- `title` (text): Its title

**Example output**

```json
{
  "body": "Wants a quote for 40 seats by Friday.",
  "created_at": "2026-11-05T09:40:00.000Z",
  "id": "2e917fc8-f0df-4cc2-bd7b-ab2f86f7b7d2",
  "link": "https://crm.example.com/object/note/2e917fc8-f0df-4cc2-bd7b-ab2f86f7b7d2",
  "linked_to": [
    "7a93d1e5-3f74-4945-8a65-d7f996083f72"
  ],
  "title": "Call with Ada"
}
```

### Create company

Add a company to Twenty. Twenty refuses a second company with the same website; use 'Create or update company' to avoid that.

**Inputs**

- Name (`name`, text, required): What the company is called.
- Website (`domain`, text): Its website, such as acme.com. Twenty allows one company per website.
- Street (`street`, text): Its street address.
- City (`city`, text): Its city.
- Postcode (`postcode`, text): Its postcode or ZIP code.
- State (`state`, text): Its state or region.
- Country (`country`, text): Its country.
- LinkedIn (`linkedin`, text): Its LinkedIn address.
- Account owner (`account_owner`, text): The workspace member who owns the account, or their email.
- Custom fields (`custom_fields`, object): Fields your workspace added, by their API name, such as {"leadSource": "Website"}. A field's API name ends its address under Settings > Data model.

**Outputs**

- `account_owner_id` (text): The workspace member who owns the account
- `account_owner_name` (text): Their name
- `annual_revenue` (number): Its annual revenue; 0 if not set
- `city` (text): Its city
- `country` (text): Its country
- `created_at` (text): When it was added to Twenty (ISO 8601)
- `custom_fields` (object): Fields your workspace added, by their API name, as Twenty gives them
- `domain` (text): Its website's domain, such as acme.com
- `id` (text): The company's ID
- `link` (text): A link to it in Twenty; empty if the server doesn't say its address
- `linkedin` (text): Its LinkedIn address
- `name` (text): Its name
- `postcode` (text): Its postcode
- `state` (text): Its state or region
- `street` (text): Its street address
- `updated_at` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "account_owner_id": "98b91eab-7c99-4759-9a2b-892a0c12465a",
  "account_owner_name": "Grace Hopper",
  "annual_revenue": 0,
  "city": "London",
  "country": "United Kingdom",
  "created_at": "2026-11-05T09:00:00.000Z",
  "custom_fields": {},
  "domain": "analytical.example.com",
  "id": "1f70157c-4ea5-4d81-bc49-e1401abfbb94",
  "link": "https://crm.example.com/object/company/1f70157c-4ea5-4d81-bc49-e1401abfbb94",
  "linkedin": "",
  "name": "Analytical Engines",
  "postcode": "NW1 5LR",
  "state": "",
  "street": "12 Marylebone Road",
  "updated_at": "2026-11-05T09:00:00.000Z"
}
```

### Create opportunity

Add an opportunity (a deal) to the pipeline, with its amount, stage, company and point of contact.

**Inputs**

- Name (`name`, text, required): What the opportunity is called.
- Amount (`amount`, number): How much it's worth, such as 12000. At least 0.
- Currency (`currency`, text): The amount's three-letter currency code, such as EUR. Defaults to USD.
- Close date (`close_date`, date): When it's expected to close.
- Stage (`stage`, text): The stage it starts in. Leave blank for the first stage.
- Company (`company`, text): The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Point of contact (`point_of_contact`, text): The person's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Owner (`owner`, text): The workspace member who owns it, or their email.
- Custom fields (`custom_fields`, object): Fields your workspace added, by their API name, such as {"leadSource": "Website"}. A field's API name ends its address under Settings > Data model.

**Outputs**

- `amount` (number): How much it's worth; 0 if not set
- `close_date` (text): When it's expected to close (YYYY-MM-DD)
- `company_id` (text): The company's ID; empty if none
- `company_name` (text): The company's name
- `created_at` (text): When it was added to Twenty (ISO 8601)
- `currency` (text): The amount's currency, such as USD
- `custom_fields` (object): Fields your workspace added, by their API name, as Twenty gives them
- `id` (text): The opportunity's ID
- `link` (text): A link to it in Twenty; empty if the server doesn't say its address
- `name` (text): Its name
- `owner_id` (text): The workspace member who owns it
- `owner_name` (text): Their name
- `point_of_contact_id` (text): The point of contact's person ID
- `point_of_contact_name` (text): The point of contact's name
- `stage` (text): Its stage, as Twenty stores it, such as PROPOSAL
- `stage_label` (text): Its stage, as Twenty shows it, such as Proposal
- `updated_at` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "amount": 12000,
  "close_date": "2026-12-15",
  "company_id": "1f70157c-4ea5-4d81-bc49-e1401abfbb94",
  "company_name": "Analytical Engines",
  "created_at": "2026-11-05T09:00:00.000Z",
  "currency": "USD",
  "custom_fields": {},
  "id": "2c88d459-bfee-44a5-a738-ac2b688fcdb1",
  "link": "https://crm.example.com/object/opportunity/2c88d459-bfee-44a5-a738-ac2b688fcdb1",
  "name": "Analytical Engines renewal",
  "owner_id": "98b91eab-7c99-4759-9a2b-892a0c12465a",
  "owner_name": "Grace Hopper",
  "point_of_contact_id": "7a93d1e5-3f74-4945-8a65-d7f996083f72",
  "point_of_contact_name": "Ada Lovelace",
  "stage": "PROPOSAL",
  "stage_label": "Proposal",
  "updated_at": "2026-11-05T09:30:00.000Z"
}
```

### Create or update company

Update the company with this website, or add it if no company has it. Fields left blank keep what it has.

**Inputs**

- Website (`domain`, text, required): The website to match the company on, such as acme.com; it's added if no company has it.
- Name (`name`, text): What the company is called. Leave blank to keep its name.
- Street (`street`, text): Its street address.
- City (`city`, text): Its city.
- Postcode (`postcode`, text): Its postcode or ZIP code.
- State (`state`, text): Its state or region.
- Country (`country`, text): Its country.
- LinkedIn (`linkedin`, text): Its LinkedIn address.
- Account owner (`account_owner`, text): The workspace member who owns the account, or their email.
- Custom fields (`custom_fields`, object): Fields your workspace added, by their API name, such as {"leadSource": "Website"}. A field's API name ends its address under Settings > Data model.

**Outputs**

- `account_owner_id` (text): The workspace member who owns the account
- `account_owner_name` (text): Their name
- `annual_revenue` (number): Its annual revenue; 0 if not set
- `city` (text): Its city
- `country` (text): Its country
- `created` (true/false): True if it was added, false if it was updated
- `created_at` (text): When it was added to Twenty (ISO 8601)
- `custom_fields` (object): Fields your workspace added, by their API name, as Twenty gives them
- `domain` (text): Its website's domain, such as acme.com
- `id` (text): The company's ID
- `link` (text): A link to it in Twenty; empty if the server doesn't say its address
- `linkedin` (text): Its LinkedIn address
- `name` (text): Its name
- `postcode` (text): Its postcode
- `state` (text): Its state or region
- `street` (text): Its street address
- `updated_at` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "account_owner_id": "98b91eab-7c99-4759-9a2b-892a0c12465a",
  "account_owner_name": "Grace Hopper",
  "annual_revenue": 0,
  "city": "London",
  "country": "United Kingdom",
  "created": true,
  "created_at": "2026-11-05T09:00:00.000Z",
  "custom_fields": {},
  "domain": "analytical.example.com",
  "id": "1f70157c-4ea5-4d81-bc49-e1401abfbb94",
  "link": "https://crm.example.com/object/company/1f70157c-4ea5-4d81-bc49-e1401abfbb94",
  "linkedin": "",
  "name": "Analytical Engines",
  "postcode": "NW1 5LR",
  "state": "",
  "street": "12 Marylebone Road",
  "updated_at": "2026-11-05T09:00:00.000Z"
}
```

### Create or update person

Update the person with this email, or add them if nobody has it, such as for a form or sign-up. Fields left blank keep what they have.

**Inputs**

- Email (`email`, text, required): The email to match the person on; they're added if nobody has it.
- First name (`first_name`, text): Their first name.
- Last name (`last_name`, text): Their last name.
- Phone (`phone`, text): Their phone number with its country code, such as +1 415 555 0134.
- Job title (`job_title`, text): Their job title, such as Head of Sales.
- Company (`company`, text): The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- LinkedIn (`linkedin`, text): Their LinkedIn address.
- Custom fields (`custom_fields`, object): Fields your workspace added, by their API name, such as {"leadSource": "Website"}. A field's API name ends its address under Settings > Data model.

**Outputs**

- `company_id` (text): Their company's ID; empty if none
- `company_name` (text): Their company's name
- `created` (true/false): True if it was added, false if it was updated
- `created_at` (text): When it was added to Twenty (ISO 8601)
- `custom_fields` (object): Fields your workspace added, by their API name, as Twenty gives them
- `email` (text): Their primary email
- `first_name` (text): Their first name
- `id` (text): The person's ID
- `job_title` (text): Their job title
- `last_name` (text): Their last name
- `link` (text): A link to it in Twenty; empty if the server doesn't say its address
- `linkedin` (text): Their LinkedIn address
- `name` (text): Their full name
- `other_emails` (list): Their other emails
- `phone` (text): Their primary phone number, with its country code
- `updated_at` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "company_id": "1f70157c-4ea5-4d81-bc49-e1401abfbb94",
  "company_name": "Analytical Engines",
  "created": true,
  "created_at": "2026-11-05T09:00:00.000Z",
  "custom_fields": {},
  "email": "ada@analytical.example.com",
  "first_name": "Ada",
  "id": "7a93d1e5-3f74-4945-8a65-d7f996083f72",
  "job_title": "Head of Engineering",
  "last_name": "Lovelace",
  "link": "https://crm.example.com/object/person/7a93d1e5-3f74-4945-8a65-d7f996083f72",
  "linkedin": "linkedin.com/in/ada",
  "name": "Ada Lovelace",
  "other_emails": [],
  "phone": "+1 4155550134",
  "updated_at": "2026-11-05T09:00:00.000Z"
}
```

### Create person

Add a person to Twenty. Twenty refuses a second person with the same email; use 'Create or update person' for sign-ups.

**Inputs**

- First name (`first_name`, text): Their first name.
- Last name (`last_name`, text): Their last name.
- Email (`email`, text): Their email. Twenty allows one person per email.
- Phone (`phone`, text): Their phone number with its country code, such as +1 415 555 0134.
- Job title (`job_title`, text): Their job title, such as Head of Sales.
- Company (`company`, text): The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- LinkedIn (`linkedin`, text): Their LinkedIn address.
- Custom fields (`custom_fields`, object): Fields your workspace added, by their API name, such as {"leadSource": "Website"}. A field's API name ends its address under Settings > Data model.

**Outputs**

- `company_id` (text): Their company's ID; empty if none
- `company_name` (text): Their company's name
- `created_at` (text): When it was added to Twenty (ISO 8601)
- `custom_fields` (object): Fields your workspace added, by their API name, as Twenty gives them
- `email` (text): Their primary email
- `first_name` (text): Their first name
- `id` (text): The person's ID
- `job_title` (text): Their job title
- `last_name` (text): Their last name
- `link` (text): A link to it in Twenty; empty if the server doesn't say its address
- `linkedin` (text): Their LinkedIn address
- `name` (text): Their full name
- `other_emails` (list): Their other emails
- `phone` (text): Their primary phone number, with its country code
- `updated_at` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "company_id": "1f70157c-4ea5-4d81-bc49-e1401abfbb94",
  "company_name": "Analytical Engines",
  "created_at": "2026-11-05T09:00:00.000Z",
  "custom_fields": {},
  "email": "ada@analytical.example.com",
  "first_name": "Ada",
  "id": "7a93d1e5-3f74-4945-8a65-d7f996083f72",
  "job_title": "Head of Engineering",
  "last_name": "Lovelace",
  "link": "https://crm.example.com/object/person/7a93d1e5-3f74-4945-8a65-d7f996083f72",
  "linkedin": "linkedin.com/in/ada",
  "name": "Ada Lovelace",
  "other_emails": [],
  "phone": "+1 4155550134",
  "updated_at": "2026-11-05T09:00:00.000Z"
}
```

### Create task

Add a task, given to a workspace member with a due date, and linked to the person, company or opportunity it's about.

**Inputs**

- Title (`title`, text, required): What needs doing.
- Details (`body`, text): More about it. Markdown, such as **bold** and lists, is kept.
- Due (`due_at`, date and time): When it's due.
- Assignee (`assignee`, text): Who it's for, or their email.
- Status (`status`, text): Where it stands. Leave blank for To do. One of: `TODO` (To do), `IN_PROGRESS` (In progress), `DONE`.
- Person (`person`, text): The person's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Company (`company`, text): The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Opportunity (`opportunity`, text): The opportunity's ID, from another Twenty step or the trigger, or a link to it in Twenty.

**Outputs**

- `assignee_id` (text): The workspace member it's given to
- `assignee_name` (text): Their name
- `body` (text): Its details
- `created_at` (text): When it was added (ISO 8601)
- `due_at` (text): When it's due (ISO 8601); empty if not set
- `id` (text): The task's ID
- `link` (text): A link to it in Twenty; empty if the server doesn't say its address
- `linked_to` (list): The IDs of the records it's about
- `status` (text): To do, In progress or Done
- `title` (text): What needs doing

**Example output**

```json
{
  "assignee_id": "98b91eab-7c99-4759-9a2b-892a0c12465a",
  "assignee_name": "Grace Hopper",
  "body": "40 seats, annual.",
  "created_at": "2026-11-05T09:41:00.000Z",
  "due_at": "2026-11-07T17:00:00.000Z",
  "id": "1d871006-bd30-49a2-a086-e33e1707bacf",
  "link": "https://crm.example.com/object/task/1d871006-bd30-49a2-a086-e33e1707bacf",
  "linked_to": [
    "2c88d459-bfee-44a5-a738-ac2b688fcdb1"
  ],
  "status": "To do",
  "title": "Send Ada the quote"
}
```

### Delete record

Delete a person, company, opportunity, note or task. It goes to Twenty's deleted records, where it can be restored.

**Inputs**

- Type (`record_type`, text, required): What kind of record it is. One of: `person`, `company`, `opportunity`, `note`, `task`.
- Record (`record`, text, required): The record's ID, from another Twenty step or the trigger, or a link to it in Twenty.

**Outputs**

- `deleted` (true/false): True once deleted
- `id` (text): The record's ID
- `record_type` (text): person, company, opportunity, note or task

**Example output**

```json
{
  "deleted": true,
  "id": "7a93d1e5-3f74-4945-8a65-d7f996083f72",
  "record_type": "person"
}
```

### Find companies

Find companies by name or website, newest first. Leave both blank to list the newest.

**Inputs**

- Name (`name`, text): Words in the company's name.
- Website (`domain`, text): Its website, such as acme.com.
- How many (`limit`, number): The most to list, newest first. Defaults to 25. From 1 to 100.

**Outputs**

- `companies` (list): The companies found
- `count` (number): How many are listed
- `total` (number): How many match in all

**Example output**

```json
{
  "companies": [
    {
      "account_owner_id": "98b91eab-7c99-4759-9a2b-892a0c12465a",
      "account_owner_name": "Grace Hopper",
      "annual_revenue": 0,
      "city": "London",
      "country": "United Kingdom",
      "created_at": "2026-11-05T09:00:00.000Z",
      "custom_fields": {},
      "domain": "analytical.example.com",
      "id": "1f70157c-4ea5-4d81-bc49-e1401abfbb94",
      "link": "https://crm.example.com/object/company/1f70157c-4ea5-4d81-bc49-e1401abfbb94",
      "linkedin": "",
      "name": "Analytical Engines",
      "postcode": "NW1 5LR",
      "state": "",
      "street": "12 Marylebone Road",
      "updated_at": "2026-11-05T09:00:00.000Z"
    }
  ],
  "count": 1,
  "total": 1
}
```

### Find opportunities

Find opportunities by name, stage or company, newest first. Leave every field blank to list the newest.

**Inputs**

- Name (`name`, text): Words in the opportunity's name.
- Stage (`stage`, text): Only opportunities in this stage.
- Company (`company`, text): The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- How many (`limit`, number): The most to list, newest first. Defaults to 25. From 1 to 100.

**Outputs**

- `count` (number): How many are listed
- `opportunities` (list): The opportunities found
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "opportunities": [
    {
      "amount": 12000,
      "close_date": "2026-12-15",
      "company_id": "1f70157c-4ea5-4d81-bc49-e1401abfbb94",
      "company_name": "Analytical Engines",
      "created_at": "2026-11-05T09:00:00.000Z",
      "currency": "USD",
      "custom_fields": {},
      "id": "2c88d459-bfee-44a5-a738-ac2b688fcdb1",
      "link": "https://crm.example.com/object/opportunity/2c88d459-bfee-44a5-a738-ac2b688fcdb1",
      "name": "Analytical Engines renewal",
      "owner_id": "98b91eab-7c99-4759-9a2b-892a0c12465a",
      "owner_name": "Grace Hopper",
      "point_of_contact_id": "7a93d1e5-3f74-4945-8a65-d7f996083f72",
      "point_of_contact_name": "Ada Lovelace",
      "stage": "PROPOSAL",
      "stage_label": "Proposal",
      "updated_at": "2026-11-05T09:30:00.000Z"
    }
  ],
  "total": 1
}
```

### Find people

Find people by email, name or company, newest first. Leave every field blank to list the newest.

**Inputs**

- Email (`email`, text): Their email, primary or other.
- Name (`name`, text): Words in their name, such as Ada or Ada Lovelace.
- Company (`company`, text): The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- How many (`limit`, number): The most to list, newest first. Defaults to 25. From 1 to 100.

**Outputs**

- `count` (number): How many are listed
- `people` (list): The people found
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "people": [
    {
      "company_id": "1f70157c-4ea5-4d81-bc49-e1401abfbb94",
      "company_name": "Analytical Engines",
      "created_at": "2026-11-05T09:00:00.000Z",
      "custom_fields": {},
      "email": "ada@analytical.example.com",
      "first_name": "Ada",
      "id": "7a93d1e5-3f74-4945-8a65-d7f996083f72",
      "job_title": "Head of Engineering",
      "last_name": "Lovelace",
      "link": "https://crm.example.com/object/person/7a93d1e5-3f74-4945-8a65-d7f996083f72",
      "linkedin": "linkedin.com/in/ada",
      "name": "Ada Lovelace",
      "other_emails": [],
      "phone": "+1 4155550134",
      "updated_at": "2026-11-05T09:00:00.000Z"
    }
  ],
  "total": 1
}
```

### Get company

Get a company's details, with its account owner's name.

**Inputs**

- Company (`company`, text, required): The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.

**Outputs**

- `account_owner_id` (text): The workspace member who owns the account
- `account_owner_name` (text): Their name
- `annual_revenue` (number): Its annual revenue; 0 if not set
- `city` (text): Its city
- `country` (text): Its country
- `created_at` (text): When it was added to Twenty (ISO 8601)
- `custom_fields` (object): Fields your workspace added, by their API name, as Twenty gives them
- `domain` (text): Its website's domain, such as acme.com
- `id` (text): The company's ID
- `link` (text): A link to it in Twenty; empty if the server doesn't say its address
- `linkedin` (text): Its LinkedIn address
- `name` (text): Its name
- `postcode` (text): Its postcode
- `state` (text): Its state or region
- `street` (text): Its street address
- `updated_at` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "account_owner_id": "98b91eab-7c99-4759-9a2b-892a0c12465a",
  "account_owner_name": "Grace Hopper",
  "annual_revenue": 0,
  "city": "London",
  "country": "United Kingdom",
  "created_at": "2026-11-05T09:00:00.000Z",
  "custom_fields": {},
  "domain": "analytical.example.com",
  "id": "1f70157c-4ea5-4d81-bc49-e1401abfbb94",
  "link": "https://crm.example.com/object/company/1f70157c-4ea5-4d81-bc49-e1401abfbb94",
  "linkedin": "",
  "name": "Analytical Engines",
  "postcode": "NW1 5LR",
  "state": "",
  "street": "12 Marylebone Road",
  "updated_at": "2026-11-05T09:00:00.000Z"
}
```

### Get opportunity

Get an opportunity's details, with its stage and the names of its company, point of contact and owner.

**Inputs**

- Opportunity (`opportunity`, text, required): The opportunity's ID, from another Twenty step or the trigger, or a link to it in Twenty.

**Outputs**

- `amount` (number): How much it's worth; 0 if not set
- `close_date` (text): When it's expected to close (YYYY-MM-DD)
- `company_id` (text): The company's ID; empty if none
- `company_name` (text): The company's name
- `created_at` (text): When it was added to Twenty (ISO 8601)
- `currency` (text): The amount's currency, such as USD
- `custom_fields` (object): Fields your workspace added, by their API name, as Twenty gives them
- `id` (text): The opportunity's ID
- `link` (text): A link to it in Twenty; empty if the server doesn't say its address
- `name` (text): Its name
- `owner_id` (text): The workspace member who owns it
- `owner_name` (text): Their name
- `point_of_contact_id` (text): The point of contact's person ID
- `point_of_contact_name` (text): The point of contact's name
- `stage` (text): Its stage, as Twenty stores it, such as PROPOSAL
- `stage_label` (text): Its stage, as Twenty shows it, such as Proposal
- `updated_at` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "amount": 12000,
  "close_date": "2026-12-15",
  "company_id": "1f70157c-4ea5-4d81-bc49-e1401abfbb94",
  "company_name": "Analytical Engines",
  "created_at": "2026-11-05T09:00:00.000Z",
  "currency": "USD",
  "custom_fields": {},
  "id": "2c88d459-bfee-44a5-a738-ac2b688fcdb1",
  "link": "https://crm.example.com/object/opportunity/2c88d459-bfee-44a5-a738-ac2b688fcdb1",
  "name": "Analytical Engines renewal",
  "owner_id": "98b91eab-7c99-4759-9a2b-892a0c12465a",
  "owner_name": "Grace Hopper",
  "point_of_contact_id": "7a93d1e5-3f74-4945-8a65-d7f996083f72",
  "point_of_contact_name": "Ada Lovelace",
  "stage": "PROPOSAL",
  "stage_label": "Proposal",
  "updated_at": "2026-11-05T09:30:00.000Z"
}
```

### Get person

Get a person's details, with their company's name.

**Inputs**

- Person (`person`, text, required): The person's ID, from another Twenty step or the trigger, or a link to it in Twenty.

**Outputs**

- `company_id` (text): Their company's ID; empty if none
- `company_name` (text): Their company's name
- `created_at` (text): When it was added to Twenty (ISO 8601)
- `custom_fields` (object): Fields your workspace added, by their API name, as Twenty gives them
- `email` (text): Their primary email
- `first_name` (text): Their first name
- `id` (text): The person's ID
- `job_title` (text): Their job title
- `last_name` (text): Their last name
- `link` (text): A link to it in Twenty; empty if the server doesn't say its address
- `linkedin` (text): Their LinkedIn address
- `name` (text): Their full name
- `other_emails` (list): Their other emails
- `phone` (text): Their primary phone number, with its country code
- `updated_at` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "company_id": "1f70157c-4ea5-4d81-bc49-e1401abfbb94",
  "company_name": "Analytical Engines",
  "created_at": "2026-11-05T09:00:00.000Z",
  "custom_fields": {},
  "email": "ada@analytical.example.com",
  "first_name": "Ada",
  "id": "7a93d1e5-3f74-4945-8a65-d7f996083f72",
  "job_title": "Head of Engineering",
  "last_name": "Lovelace",
  "link": "https://crm.example.com/object/person/7a93d1e5-3f74-4945-8a65-d7f996083f72",
  "linkedin": "linkedin.com/in/ada",
  "name": "Ada Lovelace",
  "other_emails": [],
  "phone": "+1 4155550134",
  "updated_at": "2026-11-05T09:00:00.000Z"
}
```

### List workspace members

List everyone in the workspace, who can own records and be given tasks.

**Inputs**: None.

**Outputs**

- `count` (number): How many
- `members` (list): Everyone in the workspace

**Example output**

```json
{
  "count": 1,
  "members": [
    {
      "email": "grace@example.com",
      "id": "98b91eab-7c99-4759-9a2b-892a0c12465a",
      "name": "Grace Hopper"
    }
  ]
}
```

### Update company

Change a company's details. Fields left blank keep what it has.

**Inputs**

- Company (`company`, text, required): The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Name (`name`, text): A new name. Leave blank to keep it.
- Website (`domain`, text): Its website, such as acme.com. Twenty allows one company per website.
- Street (`street`, text): Its street address.
- City (`city`, text): Its city.
- Postcode (`postcode`, text): Its postcode or ZIP code.
- State (`state`, text): Its state or region.
- Country (`country`, text): Its country.
- LinkedIn (`linkedin`, text): Its LinkedIn address.
- Account owner (`account_owner`, text): The workspace member who owns the account, or their email.
- Custom fields (`custom_fields`, object): Fields your workspace added, by their API name, such as {"leadSource": "Website"}. A field's API name ends its address under Settings > Data model.

**Outputs**

- `account_owner_id` (text): The workspace member who owns the account
- `account_owner_name` (text): Their name
- `annual_revenue` (number): Its annual revenue; 0 if not set
- `city` (text): Its city
- `country` (text): Its country
- `created_at` (text): When it was added to Twenty (ISO 8601)
- `custom_fields` (object): Fields your workspace added, by their API name, as Twenty gives them
- `domain` (text): Its website's domain, such as acme.com
- `id` (text): The company's ID
- `link` (text): A link to it in Twenty; empty if the server doesn't say its address
- `linkedin` (text): Its LinkedIn address
- `name` (text): Its name
- `postcode` (text): Its postcode
- `state` (text): Its state or region
- `street` (text): Its street address
- `updated_at` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "account_owner_id": "98b91eab-7c99-4759-9a2b-892a0c12465a",
  "account_owner_name": "Grace Hopper",
  "annual_revenue": 0,
  "city": "London",
  "country": "United Kingdom",
  "created_at": "2026-11-05T09:00:00.000Z",
  "custom_fields": {},
  "domain": "analytical.example.com",
  "id": "1f70157c-4ea5-4d81-bc49-e1401abfbb94",
  "link": "https://crm.example.com/object/company/1f70157c-4ea5-4d81-bc49-e1401abfbb94",
  "linkedin": "",
  "name": "Analytical Engines",
  "postcode": "NW1 5LR",
  "state": "",
  "street": "12 Marylebone Road",
  "updated_at": "2026-11-05T09:00:00.000Z"
}
```

### Update opportunity

Change an opportunity, such as moving it to another stage. Fields left blank keep what it has.

**Inputs**

- Opportunity (`opportunity`, text, required): The opportunity's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Name (`name`, text): A new name. Leave blank to keep it.
- Amount (`amount`, number): How much it's worth, such as 12000. At least 0.
- Currency (`currency`, text): The amount's three-letter currency code, such as EUR. Defaults to USD.
- Close date (`close_date`, date): When it's expected to close.
- Stage (`stage`, text): The stage to move it to. Leave blank to keep it where it is.
- Company (`company`, text): The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Point of contact (`point_of_contact`, text): The person's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Owner (`owner`, text): The workspace member who owns it, or their email.
- Custom fields (`custom_fields`, object): Fields your workspace added, by their API name, such as {"leadSource": "Website"}. A field's API name ends its address under Settings > Data model.

**Outputs**

- `amount` (number): How much it's worth; 0 if not set
- `close_date` (text): When it's expected to close (YYYY-MM-DD)
- `company_id` (text): The company's ID; empty if none
- `company_name` (text): The company's name
- `created_at` (text): When it was added to Twenty (ISO 8601)
- `currency` (text): The amount's currency, such as USD
- `custom_fields` (object): Fields your workspace added, by their API name, as Twenty gives them
- `id` (text): The opportunity's ID
- `link` (text): A link to it in Twenty; empty if the server doesn't say its address
- `name` (text): Its name
- `owner_id` (text): The workspace member who owns it
- `owner_name` (text): Their name
- `point_of_contact_id` (text): The point of contact's person ID
- `point_of_contact_name` (text): The point of contact's name
- `stage` (text): Its stage, as Twenty stores it, such as PROPOSAL
- `stage_label` (text): Its stage, as Twenty shows it, such as Proposal
- `updated_at` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "amount": 12000,
  "close_date": "2026-12-15",
  "company_id": "1f70157c-4ea5-4d81-bc49-e1401abfbb94",
  "company_name": "Analytical Engines",
  "created_at": "2026-11-05T09:00:00.000Z",
  "currency": "USD",
  "custom_fields": {},
  "id": "2c88d459-bfee-44a5-a738-ac2b688fcdb1",
  "link": "https://crm.example.com/object/opportunity/2c88d459-bfee-44a5-a738-ac2b688fcdb1",
  "name": "Analytical Engines renewal",
  "owner_id": "98b91eab-7c99-4759-9a2b-892a0c12465a",
  "owner_name": "Grace Hopper",
  "point_of_contact_id": "7a93d1e5-3f74-4945-8a65-d7f996083f72",
  "point_of_contact_name": "Ada Lovelace",
  "stage": "PROPOSAL",
  "stage_label": "Proposal",
  "updated_at": "2026-11-05T09:30:00.000Z"
}
```

### Update person

Change a person's details. Fields left blank keep what they have.

**Inputs**

- Person (`person`, text, required): The person's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- First name (`first_name`, text): Their first name.
- Last name (`last_name`, text): Their last name.
- Email (`email`, text): Their email. Twenty allows one person per email.
- Phone (`phone`, text): Their phone number with its country code, such as +1 415 555 0134.
- Job title (`job_title`, text): Their job title, such as Head of Sales.
- Company (`company`, text): The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- LinkedIn (`linkedin`, text): Their LinkedIn address.
- Custom fields (`custom_fields`, object): Fields your workspace added, by their API name, such as {"leadSource": "Website"}. A field's API name ends its address under Settings > Data model.

**Outputs**

- `company_id` (text): Their company's ID; empty if none
- `company_name` (text): Their company's name
- `created_at` (text): When it was added to Twenty (ISO 8601)
- `custom_fields` (object): Fields your workspace added, by their API name, as Twenty gives them
- `email` (text): Their primary email
- `first_name` (text): Their first name
- `id` (text): The person's ID
- `job_title` (text): Their job title
- `last_name` (text): Their last name
- `link` (text): A link to it in Twenty; empty if the server doesn't say its address
- `linkedin` (text): Their LinkedIn address
- `name` (text): Their full name
- `other_emails` (list): Their other emails
- `phone` (text): Their primary phone number, with its country code
- `updated_at` (text): When it last changed (ISO 8601)

**Example output**

```json
{
  "company_id": "1f70157c-4ea5-4d81-bc49-e1401abfbb94",
  "company_name": "Analytical Engines",
  "created_at": "2026-11-05T09:00:00.000Z",
  "custom_fields": {},
  "email": "ada@analytical.example.com",
  "first_name": "Ada",
  "id": "7a93d1e5-3f74-4945-8a65-d7f996083f72",
  "job_title": "Head of Engineering",
  "last_name": "Lovelace",
  "link": "https://crm.example.com/object/person/7a93d1e5-3f74-4945-8a65-d7f996083f72",
  "linkedin": "linkedin.com/in/ada",
  "name": "Ada Lovelace",
  "other_emails": [],
  "phone": "+1 4155550134",
  "updated_at": "2026-11-05T09:00:00.000Z"
}
```
