NudgeLink Integrations API

The integrations API from NudgeLink — 7 operation(s) for integrations.

GitHub OpenAPI

Operations 7

POST /api/v1/integrations/hubspot/connect Connect #
GET /api/v1/integrations/hubspot/callback Callback #
GET /api/v1/integrations/hubspot/status Get Status #
GET /api/v1/integrations/hubspot/deals/pipelines Deal Pipelines #
PUT /api/v1/integrations/hubspot/deals Set Deal Settings #
POST /api/v1/integrations/hubspot/sync Sync Now #
POST /api/v1/integrations/hubspot/disconnect Disconnect #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/nudgelink-co:nudgelink-co-integrations-api"
All apis
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.

Get an API 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 Specification

nudgelink-co-integrations-api-openapi.yml Raw ↑
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