Twenty

App · 18 actions

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.

Actions

ActionWhat it does
Add noteAdd a note to a person, a company or an opportunity, shown on its timeline.
Create companyAdd a company to Twenty.
Create opportunityAdd an opportunity (a deal) to the pipeline, with its amount, stage, company and point of contact.
Create or update companyUpdate the company with this website, or add it if no company has it.
Create or update personUpdate the person with this email, or add them if nobody has it, such as for a form or sign-up.
Create personAdd a person to Twenty.
Create taskAdd a task, given to a workspace member with a due date, and linked to the person, company or opportunity it's about.
Delete recordDelete a person, company, opportunity, note or task.
Find companiesFind companies by name or website, newest first.
Find opportunitiesFind opportunities by name, stage or company, newest first.
Find peopleFind people by email, name or company, newest first.
Get companyGet a company's details, with its account owner's name.
Get opportunityGet an opportunity's details, with its stage and the names of its company, point of contact and owner.
Get personGet a person's details, with their company's name.
List workspace membersList everyone in the workspace, who can own records and be given tasks.
Update companyChange a company's details.
Update opportunityChange an opportunity, such as moving it to another stage.
Update personChange a person's details.

Add note

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

Inputs

TitletitletextRequired
The note's title.
Notebodytext
What the note says. Markdown, such as **bold** and lists, is kept.
Personpersontext
The person's ID, from another Twenty step or the trigger, or a link to it in Twenty.
Companycompanytext
The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
Opportunityopportunitytext
The opportunity's ID, from another Twenty step or the trigger, or a link to it in Twenty.

Outputs

bodytext
What it says
created_attext
When it was added (ISO 8601)
idtext
The note's ID
linktext
A link to it in Twenty; empty if the server doesn't say its address
linked_tolist
The IDs of the records it's on
titletext
Its title
Example output
{
  "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

NamenametextRequired
What the company is called.
Websitedomaintext
Its website, such as acme.com. Twenty allows one company per website.
Streetstreettext
Its street address.
Citycitytext
Its city.
Postcodepostcodetext
Its postcode or ZIP code.
Statestatetext
Its state or region.
Countrycountrytext
Its country.
LinkedInlinkedintext
Its LinkedIn address.
Account owneraccount_ownertext
The workspace member who owns the account, or their email.
Custom fieldscustom_fieldsobject
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_idtext
The workspace member who owns the account
account_owner_nametext
Their name
annual_revenuenumber
Its annual revenue; 0 if not set
citytext
Its city
countrytext
Its country
created_attext
When it was added to Twenty (ISO 8601)
custom_fieldsobject
Fields your workspace added, by their API name, as Twenty gives them
domaintext
Its website's domain, such as acme.com
idtext
The company's ID
linktext
A link to it in Twenty; empty if the server doesn't say its address
linkedintext
Its LinkedIn address
nametext
Its name
postcodetext
Its postcode
statetext
Its state or region
streettext
Its street address
updated_attext
When it last changed (ISO 8601)
Example output
{
  "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

NamenametextRequired
What the opportunity is called.
Amountamountnumber
How much it's worth, such as 12000.At least 0.
Currencycurrencytext
The amount's three-letter currency code, such as EUR. Defaults to USD.
Close dateclose_datedate
When it's expected to close.
Stagestagetext
The stage it starts in. Leave blank for the first stage.
Companycompanytext
The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
Point of contactpoint_of_contacttext
The person's ID, from another Twenty step or the trigger, or a link to it in Twenty.
Ownerownertext
The workspace member who owns it, or their email.
Custom fieldscustom_fieldsobject
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

amountnumber
How much it's worth; 0 if not set
close_datetext
When it's expected to close (YYYY-MM-DD)
company_idtext
The company's ID; empty if none
company_nametext
The company's name
created_attext
When it was added to Twenty (ISO 8601)
currencytext
The amount's currency, such as USD
custom_fieldsobject
Fields your workspace added, by their API name, as Twenty gives them
idtext
The opportunity's ID
linktext
A link to it in Twenty; empty if the server doesn't say its address
nametext
Its name
owner_idtext
The workspace member who owns it
owner_nametext
Their name
point_of_contact_idtext
The point of contact's person ID
point_of_contact_nametext
The point of contact's name
stagetext
Its stage, as Twenty stores it, such as PROPOSAL
stage_labeltext
Its stage, as Twenty shows it, such as Proposal
updated_attext
When it last changed (ISO 8601)
Example output
{
  "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

WebsitedomaintextRequired
The website to match the company on, such as acme.com; it's added if no company has it.
Namenametext
What the company is called. Leave blank to keep its name.
Streetstreettext
Its street address.
Citycitytext
Its city.
Postcodepostcodetext
Its postcode or ZIP code.
Statestatetext
Its state or region.
Countrycountrytext
Its country.
LinkedInlinkedintext
Its LinkedIn address.
Account owneraccount_ownertext
The workspace member who owns the account, or their email.
Custom fieldscustom_fieldsobject
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_idtext
The workspace member who owns the account
account_owner_nametext
Their name
annual_revenuenumber
Its annual revenue; 0 if not set
citytext
Its city
countrytext
Its country
createdtrue/false
True if it was added, false if it was updated
created_attext
When it was added to Twenty (ISO 8601)
custom_fieldsobject
Fields your workspace added, by their API name, as Twenty gives them
domaintext
Its website's domain, such as acme.com
idtext
The company's ID
linktext
A link to it in Twenty; empty if the server doesn't say its address
linkedintext
Its LinkedIn address
nametext
Its name
postcodetext
Its postcode
statetext
Its state or region
streettext
Its street address
updated_attext
When it last changed (ISO 8601)
Example output
{
  "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

EmailemailtextRequired
The email to match the person on; they're added if nobody has it.
First namefirst_nametext
Their first name.
Last namelast_nametext
Their last name.
Phonephonetext
Their phone number with its country code, such as +1 415 555 0134.
Job titlejob_titletext
Their job title, such as Head of Sales.
Companycompanytext
The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
LinkedInlinkedintext
Their LinkedIn address.
Custom fieldscustom_fieldsobject
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_idtext
Their company's ID; empty if none
company_nametext
Their company's name
createdtrue/false
True if it was added, false if it was updated
created_attext
When it was added to Twenty (ISO 8601)
custom_fieldsobject
Fields your workspace added, by their API name, as Twenty gives them
emailtext
Their primary email
first_nametext
Their first name
idtext
The person's ID
job_titletext
Their job title
last_nametext
Their last name
linktext
A link to it in Twenty; empty if the server doesn't say its address
linkedintext
Their LinkedIn address
nametext
Their full name
other_emailslist
Their other emails
phonetext
Their primary phone number, with its country code
updated_attext
When it last changed (ISO 8601)
Example output
{
  "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 namefirst_nametext
Their first name.
Last namelast_nametext
Their last name.
Emailemailtext
Their email. Twenty allows one person per email.
Phonephonetext
Their phone number with its country code, such as +1 415 555 0134.
Job titlejob_titletext
Their job title, such as Head of Sales.
Companycompanytext
The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
LinkedInlinkedintext
Their LinkedIn address.
Custom fieldscustom_fieldsobject
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_idtext
Their company's ID; empty if none
company_nametext
Their company's name
created_attext
When it was added to Twenty (ISO 8601)
custom_fieldsobject
Fields your workspace added, by their API name, as Twenty gives them
emailtext
Their primary email
first_nametext
Their first name
idtext
The person's ID
job_titletext
Their job title
last_nametext
Their last name
linktext
A link to it in Twenty; empty if the server doesn't say its address
linkedintext
Their LinkedIn address
nametext
Their full name
other_emailslist
Their other emails
phonetext
Their primary phone number, with its country code
updated_attext
When it last changed (ISO 8601)
Example output
{
  "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

TitletitletextRequired
What needs doing.
Detailsbodytext
More about it. Markdown, such as **bold** and lists, is kept.
Duedue_atdate and time
When it's due.
Assigneeassigneetext
Who it's for, or their email.
Statusstatustext
Where it stands. Leave blank for To do.One of: TODO (To do), IN_PROGRESS (In progress), DONE.
Personpersontext
The person's ID, from another Twenty step or the trigger, or a link to it in Twenty.
Companycompanytext
The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
Opportunityopportunitytext
The opportunity's ID, from another Twenty step or the trigger, or a link to it in Twenty.

Outputs

assignee_idtext
The workspace member it's given to
assignee_nametext
Their name
bodytext
Its details
created_attext
When it was added (ISO 8601)
due_attext
When it's due (ISO 8601); empty if not set
idtext
The task's ID
linktext
A link to it in Twenty; empty if the server doesn't say its address
linked_tolist
The IDs of the records it's about
statustext
To do, In progress or Done
titletext
What needs doing
Example output
{
  "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

Typerecord_typetextRequired
What kind of record it is.One of: person, company, opportunity, note, task.
RecordrecordtextRequired
The record's ID, from another Twenty step or the trigger, or a link to it in Twenty.

Outputs

deletedtrue/false
True once deleted
idtext
The record's ID
record_typetext
person, company, opportunity, note or task
Example output
{
  "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

Namenametext
Words in the company's name.
Websitedomaintext
Its website, such as acme.com.
How manylimitnumber
The most to list, newest first. Defaults to 25.From 1 to 100.

Outputs

companieslist
The companies found
countnumber
How many are listed
totalnumber
How many match in all
Example output
{
  "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

Namenametext
Words in the opportunity's name.
Stagestagetext
Only opportunities in this stage.
Companycompanytext
The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
How manylimitnumber
The most to list, newest first. Defaults to 25.From 1 to 100.

Outputs

countnumber
How many are listed
opportunitieslist
The opportunities found
totalnumber
How many match in all
Example output
{
  "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

Emailemailtext
Their email, primary or other.
Namenametext
Words in their name, such as Ada or Ada Lovelace.
Companycompanytext
The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
How manylimitnumber
The most to list, newest first. Defaults to 25.From 1 to 100.

Outputs

countnumber
How many are listed
peoplelist
The people found
totalnumber
How many match in all
Example output
{
  "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

CompanycompanytextRequired
The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.

Outputs

account_owner_idtext
The workspace member who owns the account
account_owner_nametext
Their name
annual_revenuenumber
Its annual revenue; 0 if not set
citytext
Its city
countrytext
Its country
created_attext
When it was added to Twenty (ISO 8601)
custom_fieldsobject
Fields your workspace added, by their API name, as Twenty gives them
domaintext
Its website's domain, such as acme.com
idtext
The company's ID
linktext
A link to it in Twenty; empty if the server doesn't say its address
linkedintext
Its LinkedIn address
nametext
Its name
postcodetext
Its postcode
statetext
Its state or region
streettext
Its street address
updated_attext
When it last changed (ISO 8601)
Example output
{
  "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

OpportunityopportunitytextRequired
The opportunity's ID, from another Twenty step or the trigger, or a link to it in Twenty.

Outputs

amountnumber
How much it's worth; 0 if not set
close_datetext
When it's expected to close (YYYY-MM-DD)
company_idtext
The company's ID; empty if none
company_nametext
The company's name
created_attext
When it was added to Twenty (ISO 8601)
currencytext
The amount's currency, such as USD
custom_fieldsobject
Fields your workspace added, by their API name, as Twenty gives them
idtext
The opportunity's ID
linktext
A link to it in Twenty; empty if the server doesn't say its address
nametext
Its name
owner_idtext
The workspace member who owns it
owner_nametext
Their name
point_of_contact_idtext
The point of contact's person ID
point_of_contact_nametext
The point of contact's name
stagetext
Its stage, as Twenty stores it, such as PROPOSAL
stage_labeltext
Its stage, as Twenty shows it, such as Proposal
updated_attext
When it last changed (ISO 8601)
Example output
{
  "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

PersonpersontextRequired
The person's ID, from another Twenty step or the trigger, or a link to it in Twenty.

Outputs

company_idtext
Their company's ID; empty if none
company_nametext
Their company's name
created_attext
When it was added to Twenty (ISO 8601)
custom_fieldsobject
Fields your workspace added, by their API name, as Twenty gives them
emailtext
Their primary email
first_nametext
Their first name
idtext
The person's ID
job_titletext
Their job title
last_nametext
Their last name
linktext
A link to it in Twenty; empty if the server doesn't say its address
linkedintext
Their LinkedIn address
nametext
Their full name
other_emailslist
Their other emails
phonetext
Their primary phone number, with its country code
updated_attext
When it last changed (ISO 8601)
Example output
{
  "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

countnumber
How many
memberslist
Everyone in the workspace
Example output
{
  "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

CompanycompanytextRequired
The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
Namenametext
A new name. Leave blank to keep it.
Websitedomaintext
Its website, such as acme.com. Twenty allows one company per website.
Streetstreettext
Its street address.
Citycitytext
Its city.
Postcodepostcodetext
Its postcode or ZIP code.
Statestatetext
Its state or region.
Countrycountrytext
Its country.
LinkedInlinkedintext
Its LinkedIn address.
Account owneraccount_ownertext
The workspace member who owns the account, or their email.
Custom fieldscustom_fieldsobject
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_idtext
The workspace member who owns the account
account_owner_nametext
Their name
annual_revenuenumber
Its annual revenue; 0 if not set
citytext
Its city
countrytext
Its country
created_attext
When it was added to Twenty (ISO 8601)
custom_fieldsobject
Fields your workspace added, by their API name, as Twenty gives them
domaintext
Its website's domain, such as acme.com
idtext
The company's ID
linktext
A link to it in Twenty; empty if the server doesn't say its address
linkedintext
Its LinkedIn address
nametext
Its name
postcodetext
Its postcode
statetext
Its state or region
streettext
Its street address
updated_attext
When it last changed (ISO 8601)
Example output
{
  "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

OpportunityopportunitytextRequired
The opportunity's ID, from another Twenty step or the trigger, or a link to it in Twenty.
Namenametext
A new name. Leave blank to keep it.
Amountamountnumber
How much it's worth, such as 12000.At least 0.
Currencycurrencytext
The amount's three-letter currency code, such as EUR. Defaults to USD.
Close dateclose_datedate
When it's expected to close.
Stagestagetext
The stage to move it to. Leave blank to keep it where it is.
Companycompanytext
The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
Point of contactpoint_of_contacttext
The person's ID, from another Twenty step or the trigger, or a link to it in Twenty.
Ownerownertext
The workspace member who owns it, or their email.
Custom fieldscustom_fieldsobject
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

amountnumber
How much it's worth; 0 if not set
close_datetext
When it's expected to close (YYYY-MM-DD)
company_idtext
The company's ID; empty if none
company_nametext
The company's name
created_attext
When it was added to Twenty (ISO 8601)
currencytext
The amount's currency, such as USD
custom_fieldsobject
Fields your workspace added, by their API name, as Twenty gives them
idtext
The opportunity's ID
linktext
A link to it in Twenty; empty if the server doesn't say its address
nametext
Its name
owner_idtext
The workspace member who owns it
owner_nametext
Their name
point_of_contact_idtext
The point of contact's person ID
point_of_contact_nametext
The point of contact's name
stagetext
Its stage, as Twenty stores it, such as PROPOSAL
stage_labeltext
Its stage, as Twenty shows it, such as Proposal
updated_attext
When it last changed (ISO 8601)
Example output
{
  "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

PersonpersontextRequired
The person's ID, from another Twenty step or the trigger, or a link to it in Twenty.
First namefirst_nametext
Their first name.
Last namelast_nametext
Their last name.
Emailemailtext
Their email. Twenty allows one person per email.
Phonephonetext
Their phone number with its country code, such as +1 415 555 0134.
Job titlejob_titletext
Their job title, such as Head of Sales.
Companycompanytext
The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
LinkedInlinkedintext
Their LinkedIn address.
Custom fieldscustom_fieldsobject
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_idtext
Their company's ID; empty if none
company_nametext
Their company's name
created_attext
When it was added to Twenty (ISO 8601)
custom_fieldsobject
Fields your workspace added, by their API name, as Twenty gives them
emailtext
Their primary email
first_nametext
Their first name
idtext
The person's ID
job_titletext
Their job title
last_nametext
Their last name
linktext
A link to it in Twenty; empty if the server doesn't say its address
linkedintext
Their LinkedIn address
nametext
Their full name
other_emailslist
Their other emails
phonetext
Their primary phone number, with its country code
updated_attext
When it last changed (ISO 8601)
Example output
{
  "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"
}

On this page