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
| Action | What it does |
|---|---|
| Add note | Add a note to a person, a company or an opportunity, shown on its timeline. |
| Create company | Add a company to Twenty. |
| Create opportunity | Add an opportunity (a deal) to the pipeline, with its amount, stage, company and point of contact. |
| Create or update company | Update the company with this website, or add it if no company has it. |
| 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. |
| Create person | Add a person to Twenty. |
| 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. |
| Delete record | Delete a person, company, opportunity, note or task. |
| Find companies | Find companies by name or website, newest first. |
| Find opportunities | Find opportunities by name, stage or company, newest first. |
| Find people | Find people by email, name or company, newest first. |
| Get company | Get a company's details, with its account owner's name. |
| Get opportunity | Get an opportunity's details, with its stage and the names of its company, point of contact and owner. |
| Get person | Get a person's details, with their company's name. |
| List workspace members | List everyone in the workspace, who can own records and be given tasks. |
| Update company | Change a company's details. |
| Update opportunity | Change an opportunity, such as moving it to another stage. |
| Update person | Change 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
- Title
titletextRequired - The note's title.
- Note
bodytext - What the note says. Markdown, such as **bold** and lists, is kept.
- Person
persontext - The person's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Company
companytext - The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Opportunity
opportunitytext - 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
- Name
nametextRequired - What the company is called.
- Website
domaintext - Its website, such as acme.com. Twenty allows one company per website.
- Street
streettext - Its street address.
- City
citytext - Its city.
- Postcode
postcodetext - Its postcode or ZIP code.
- State
statetext - Its state or region.
- Country
countrytext - Its country.
- LinkedIn
linkedintext - Its LinkedIn address.
- Account owner
account_ownertext - The workspace member who owns the account, or their email.
- Custom fields
custom_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
- Name
nametextRequired - What the opportunity is called.
- Amount
amountnumber - How much it's worth, such as 12000.At least 0.
- Currency
currencytext - The amount's three-letter currency code, such as EUR. Defaults to USD.
- Close date
close_datedate - When it's expected to close.
- Stage
stagetext - The stage it starts in. Leave blank for the first stage.
- Company
companytext - The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Point of contact
point_of_contacttext - The person's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Owner
ownertext - The workspace member who owns it, or their email.
- Custom fields
custom_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
- Website
domaintextRequired - The website to match the company on, such as acme.com; it's added if no company has it.
- Name
nametext - What the company is called. Leave blank to keep its name.
- Street
streettext - Its street address.
- City
citytext - Its city.
- Postcode
postcodetext - Its postcode or ZIP code.
- State
statetext - Its state or region.
- Country
countrytext - Its country.
- LinkedIn
linkedintext - Its LinkedIn address.
- Account owner
account_ownertext - The workspace member who owns the account, or their email.
- Custom fields
custom_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
- Email
emailtextRequired - The email to match the person on; they're added if nobody has it.
- First name
first_nametext - Their first name.
- Last name
last_nametext - Their last name.
- Phone
phonetext - Their phone number with its country code, such as +1 415 555 0134.
- Job title
job_titletext - Their job title, such as Head of Sales.
- Company
companytext - The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- LinkedIn
linkedintext - Their LinkedIn address.
- Custom fields
custom_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 name
first_nametext - Their first name.
- Last name
last_nametext - Their last name.
- Email
emailtext - Their email. Twenty allows one person per email.
- Phone
phonetext - Their phone number with its country code, such as +1 415 555 0134.
- Job title
job_titletext - Their job title, such as Head of Sales.
- Company
companytext - The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- LinkedIn
linkedintext - Their LinkedIn address.
- Custom fields
custom_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
- Title
titletextRequired - What needs doing.
- Details
bodytext - More about it. Markdown, such as **bold** and lists, is kept.
- Due
due_atdate and time - When it's due.
- Assignee
assigneetext - Who it's for, or their email.
- Status
statustext - Where it stands. Leave blank for To do.One of:
TODO(To do),IN_PROGRESS(In progress),DONE. - Person
persontext - The person's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Company
companytext - The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Opportunity
opportunitytext - 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
- Type
record_typetextRequired - What kind of record it is.One of:
person,company,opportunity,note,task. - Record
recordtextRequired - 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
- Name
nametext - Words in the company's name.
- Website
domaintext - Its website, such as acme.com.
- How many
limitnumber - 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
- Name
nametext - Words in the opportunity's name.
- Stage
stagetext - Only opportunities in this stage.
- Company
companytext - The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- How many
limitnumber - 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
- Email
emailtext - Their email, primary or other.
- Name
nametext - Words in their name, such as Ada or Ada Lovelace.
- Company
companytext - The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- How many
limitnumber - 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
- Company
companytextRequired - 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
- Opportunity
opportunitytextRequired - 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
- Person
persontextRequired - 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
- Company
companytextRequired - The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Name
nametext - A new name. Leave blank to keep it.
- Website
domaintext - Its website, such as acme.com. Twenty allows one company per website.
- Street
streettext - Its street address.
- City
citytext - Its city.
- Postcode
postcodetext - Its postcode or ZIP code.
- State
statetext - Its state or region.
- Country
countrytext - Its country.
- LinkedIn
linkedintext - Its LinkedIn address.
- Account owner
account_ownertext - The workspace member who owns the account, or their email.
- Custom fields
custom_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
- Opportunity
opportunitytextRequired - The opportunity's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Name
nametext - A new name. Leave blank to keep it.
- Amount
amountnumber - How much it's worth, such as 12000.At least 0.
- Currency
currencytext - The amount's three-letter currency code, such as EUR. Defaults to USD.
- Close date
close_datedate - When it's expected to close.
- Stage
stagetext - The stage to move it to. Leave blank to keep it where it is.
- Company
companytext - The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Point of contact
point_of_contacttext - The person's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- Owner
ownertext - The workspace member who owns it, or their email.
- Custom fields
custom_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
- Person
persontextRequired - The person's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- First name
first_nametext - Their first name.
- Last name
last_nametext - Their last name.
- Email
emailtext - Their email. Twenty allows one person per email.
- Phone
phonetext - Their phone number with its country code, such as +1 415 555 0134.
- Job title
job_titletext - Their job title, such as Head of Sales.
- Company
companytext - The company's ID, from another Twenty step or the trigger, or a link to it in Twenty.
- LinkedIn
linkedintext - Their LinkedIn address.
- Custom fields
custom_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"
}