Actions42
- Activity Actions
- Bulk Operations Actions
- Company Actions
- Custom Object Actions
- Note Actions
- Opportunity Actions
- Person Actions
- Search Actions
- Task Actions
Opportunity → Create
AI-generatedSummary
Create a new opportunity (deal) record in Twenty CRM with required name and optional additional and custom fields.
Inputs
- Name (required) — The name of the opportunity/deal.
- Additional Fields — Optional parameters including Amount (deal value in dollars), Close Date (expected close date, ISO 8601), Company ID (ID of associated company), Point of Contact ID (ID of contact person), and Stage (pipeline stage).
- Custom Fields — Multiple custom fields specified as name-value pairs, allowing to set any custom attributes by API field names.
Output shape
a single JSON object representing the newly created opportunity record returned by the Twenty CRM API, including all set fields and assigned IDs.
The operation requires the 'Name' field and accepts additional and custom fields to fully define the opportunity. Amount fields are transformed from dollars to micros internally. Custom fields are sent according to their API names. The response includes the created opportunity data as returned by the API, with no pagination involved.
Examples
Example 1: Create a basic opportunity with only a name
Set "Name" to 'Big Deal Q3' and leave additional and custom fields empty. The node will create the opportunity with just a name.
Example 2: Create an opportunity with full details
Set "Name" to 'Acme Acquisition', "Additional Fields" Amount to 50000, Close Date to '2024-12-31T00:00:00Z', Company ID to '12345', Point of Contact ID to '67890', and Stage to 'NEW'. Add custom fields as needed with field names and values.