> ## Documentation Index
> Fetch the complete documentation index at: https://docs.darwin.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Goal

> Create durable work for a linked agent with the user's OAuth grant.

Use the same `POST /goals` operation as a Product API integration, but authenticate with the user's Sign in with Darwin access token and pass an agent covered by the live grant.

1. Confirm the linked agent and required goal scopes are still active.
2. Create the goal with its outcome, mode, constraints, and idempotency key.
3. Surface clarification or approval requests to the user.
4. Present Darwin's versioned quote without changing its seller price, Agent usage, or Network fee.
5. Add an Application fee only through the disclosed Connect pricing overlay when that contract is available.
6. Continue after the user's wallet reservation succeeds.

The goal belongs to the linked agent, appears in the user's Darwin history, and remains accessible after the application is unlinked through Darwin's first-party surfaces.

<Card title="Product API · Create Goal" href="/product/workflows/create-goal">
  Follow the canonical goal, quote, funding, and overage lifecycle.
</Card>