---
title: "Set Deal Settings"
method: PUT
path: "/api/v1/integrations/hubspot/deals"
tags: ["integrations"]
---

# Set Deal Settings

`PUT /api/v1/integrations/hubspot/deals`

## Request

- Base URL: `https://api.nudgelink.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nudgelink.co/api/v1/integrations/hubspot/deals`
- Auth: HTTP bearer

Checked against the portal's live pipelines, so a typo or a stage from
another pipeline can never be saved and fail later on a real reply.

## Request body

- DealSettingsIn: Both set = open a deal on a positive reply there; both null = no deals.
  - `pipeline_id` string, nullable
  - `stage_id` string, nullable

## Response `200`

Successful Response

- StatusOut
  - `configured` boolean, required
  - `connected` boolean, required
  - `status` string, nullable
  - `portal_id` string, nullable
  - `connected_at` string, date-time, nullable
  - `last_sync_at` string, date-time, nullable
  - `last_error` string, nullable
  - `last_error_code` string, nullable
  - `contacts_synced` integer
  - `companies_synced` integer
  - `allowed` boolean
  - `upgrade_to` string, nullable
  - `paused` boolean
  - `needs_reconnect` boolean
  - `deal_pipeline_id` string, nullable
  - `deal_stage_id` string, nullable
  - `deals_created` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/nudgelink/apis/nudgelink-api.md) · [All operations](https://skmtc.dev/nudgelink/apis/nudgelink-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nudgelink/apis/nudgelink-api/revisions/baa46e6db986?raw)
