Skip to content

Create Deal

Module · Stable

Create a deal on a company; snapshots FX rate against the main currency at creation time.

Creates a deal linked to a company. value_currency is ISO 4217; the platform snapshots the FX rate to the workspace’s main currency at creation time. Supply stage_name to use a human-readable pipeline stage label instead of stage_id. Supply source to record the lead channel (e.g. ‘Leadgen form — routario.com’) — resolved by name against the deal-source vocabulary you manage in Settings, registering an unknown label automatically.

Use after Create Company or Find Company has produced a company_id and you want to open a new sales deal at a known value and stage. The deal_id output feeds directly into Move Deal Stage, Add Note, or Create Task to build out the full opportunity record.

If the deal already exists and you only need to change its fields, use Update Deal instead. To advance an existing deal through the pipeline, use Move Deal Stage — Create Deal always mints a fresh row and will create duplicates if called repeatedly.

Configured per use: name, company_id, owner_actor_id, stage_id, stage_name, primary_contact_id, value_amount, value_currency, expected_close_date, source.

  • deal_id
  • stage_id
  • value_amount_main

Auto-generated from the skill registry (load_skills()). Do not edit by hand.