NudgeLink Integrations API
The integrations API from NudgeLink — 7 operation(s) for integrations.
The integrations API from NudgeLink — 7 operation(s) for integrations.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/nudgelink-co:nudgelink-co-integrations-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: NudgeLink Integrations API
version: 0.1.0
tags:
- name: Integrations
paths:
/api/v1/integrations/hubspot/connect:
post:
tags:
- Integrations
summary: Connect
operationId: connect_api_v1_integrations_hubspot_connect_post
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/app__api__integrations_hubspot__ConnectOut'
security:
- HTTPBearer: []
/api/v1/integrations/hubspot/callback:
get:
tags:
- Integrations
summary: Callback
description: 'HubSpot''s redirect target. Never shows a stack or token material — every
failure lands back on the settings page with a short outcome code.'
operationId: callback_api_v1_integrations_hubspot_callback_get
parameters:
- name: code
in: query
required: false
schema:
anyOf:
- type: string
maxLength: 512
- type: 'null'
title: Code
- name: state
in: query
required: false
schema:
anyOf:
- type: string
maxLength: 2048
- type: 'null'
title: State
- name: error
in: query
required: false
schema:
anyOf:
- type: string
maxLength: 128
- type: 'null'
title: Error
- name: nudgelink_hubspot_oauth
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Nudgelink Hubspot Oauth
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/integrations/hubspot/status:
get:
tags:
- Integrations
summary: Get Status
operationId: get_status_api_v1_integrations_hubspot_status_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/StatusOut'
security:
- HTTPBearer: []
/api/v1/integrations/hubspot/deals/pipelines:
get:
tags:
- Integrations
summary: Deal Pipelines
operationId: deal_pipelines_api_v1_integrations_hubspot_deals_pipelines_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
$ref: '#/components/schemas/DealPipeline'
type: array
title: Response Deal Pipelines Api V1 Integrations Hubspot Deals Pipelines Get
security:
- HTTPBearer: []
/api/v1/integrations/hubspot/deals:
put:
tags:
- Integrations
summary: Set Deal Settings
description: '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.'
operationId: set_deal_settings_api_v1_integrations_hubspot_deals_put
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DealSettingsIn'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/StatusOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/v1/integrations/hubspot/sync:
post:
tags:
- Integrations
summary: Sync Now
operationId: sync_now_api_v1_integrations_hubspot_sync_post
responses:
'202':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Sync Now Api V1 Integrations Hubspot Sync Post
security:
- HTTPBearer: []
/api/v1/integrations/hubspot/disconnect:
post:
tags:
- Integrations
summary: Disconnect
description: 'Revoke the token AND uninstall the app from the portal (both are
marketplace requirements, shown in the review video), then delete our
tokens and mappings. Local deletion happens even if HubSpot is
unreachable — the user asked to disconnect, and we must stop holding
their tokens either way. Allowed without a plan (a downgraded client must
still be able to remove us).'
operationId: disconnect_api_v1_integrations_hubspot_disconnect_post
responses:
'204':
description: Successful Response
security:
- HTTPBearer: []
components:
schemas:
DealPipeline:
properties:
id:
type: string
title: Id
label:
type: string
title: Label
stages:
items:
$ref: '#/components/schemas/DealStage'
type: array
title: Stages
type: object
required:
- id
- label
- stages
title: DealPipeline
DealSettingsIn:
properties:
pipeline_id:
anyOf:
- type: string
maxLength: 64
- type: 'null'
title: Pipeline Id
stage_id:
anyOf:
- type: string
maxLength: 64
- type: 'null'
title: Stage Id
type: object
title: DealSettingsIn
description: Both set = open a deal on a positive reply there; both null = no deals.
StatusOut:
properties:
configured:
type: boolean
title: Configured
connected:
type: boolean
title: Connected
status:
anyOf:
- type: string
- type: 'null'
title: Status
portal_id:
anyOf:
- type: string
- type: 'null'
title: Portal Id
connected_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Connected At
last_sync_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Last Sync At
last_error:
anyOf:
- type: string
- type: 'null'
title: Last Error
last_error_code:
anyOf:
- type: string
- type: 'null'
title: Last Error Code
contacts_synced:
type: integer
title: Contacts Synced
default: 0
companies_synced:
type: integer
title: Companies Synced
default: 0
allowed:
type: boolean
title: Allowed
default: true
upgrade_to:
anyOf:
- type: string
- type: 'null'
title: Upgrade To
paused:
type: boolean
title: Paused
default: false
needs_reconnect:
type: boolean
title: Needs Reconnect
default: false
deal_pipeline_id:
anyOf:
- type: string
- type: 'null'
title: Deal Pipeline Id
deal_stage_id:
anyOf:
- type: string
- type: 'null'
title: Deal Stage Id
deals_created:
type: integer
title: Deals Created
default: 0
type: object
required:
- configured
- connected
title: StatusOut
DealStage:
properties:
id:
type: string
title: Id
label:
type: string
title: Label
type: object
required:
- id
- label
title: DealStage
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
app__api__integrations_hubspot__ConnectOut:
properties:
authorize_url:
type: string
title: Authorize Url
type: object
required:
- authorize_url
title: ConnectOut
securitySchemes:
HTTPBearer:
type: http
scheme: bearer