Refold

Refold API

Refold API as documented publicly: 18 operations. Contract generated from the documentation by API Evangelist (2026-10-21); not the provider's own document.

Documentation GitHub OpenAPI

Operations 18

GET / GET / #

GET /api/v2/integration-schema/hubspot/actions GET /api/v2/integration-schema/hubspot/actions #

GET /api/v2/integration-schema/hubspot/actions/create_contact/execute Read and Write Data - Refold #

POST /api/v2/integration-schema/hubspot/actions/create_contact/execute POST /api/v2/integration-schema/hubspot/actions/create_contact/execute #

GET /api/v2/integration-schema/hubspot/actions/get_contact/execute Read and Write Data - Refold #

POST /api/v2/integration-schema/hubspot/actions/get_contact/execute POST /api/v2/integration-schema/hubspot/actions/get_contact/execute #

GET /api/v2/integration-schema/netsuite/actions GET /api/v2/integration-schema/netsuite/actions #

POST /api/v2/integration-schema/netsuite/actions/get_list_of_records_invoice/execute POST /api/v2/integration-schema/netsuite/actions/get_list_of_records_invoice/execute #

GET /api/v2/public/application GET /api/v2/public/application #

GET /api/v2/public/auth-schema/{slug} Get Auth Schema #

POST /api/v2/public/connect-url POST /api/v2/public/connect-url #

POST /api/v2/public/event/hubspot POST /api/v2/public/event/hubspot #

POST /api/v2/public/event/trigger POST /api/v2/public/event/trigger #

POST /api/v2/public/linked-account POST /api/v2/public/linked-account #

POST /api/v2/public/session-token POST /api/v2/public/session-token #

POST /api/v2/public/webhook POST /api/v2/public/webhook #

GET /api/v2/public/workflow/enabled List Enabled Workflows. #

POST /api/v2/public/workflow/{workflowid}/execute POST /api/v2/public/workflow/{workflowId}/execute #

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/refold:refold-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  title: Refold API
  version: '2026-10-21'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-21: 18 operation(s) read from 12 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; Refold has published no machine-readable contract that
    the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 14
    documentation: 4
    pages-with-code: 11
    pages-read: 12
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-21'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.refold.ai/v3/embedded/quickstart
  - https://docs.refold.ai/v3/api-reference/overview
  - https://docs.refold.ai/v3/get-started/quickstart
  - https://docs.refold.ai/v3/concepts/linked-account
  - https://docs.refold.ai/v3/embedded/use-cases/sync
  - https://docs.refold.ai/v3/connectors/my-app/events
  - https://docs.refold.ai/v3/workflows/triggers/events
  - https://docs.refold.ai/v3/connectors/my-app/webhooks
  - https://docs.refold.ai/v3/api-reference/javascript-sdk
  - https://docs.refold.ai/v3/embedded/linked-account-setup
  - https://docs.refold.ai/v3/embedded/ship-operate/testing
  - https://docs.refold.ai/v3/embedded/use-cases/read-write
servers:
- url: https://app.refold.ai
paths:
  /:
    get:
      operationId: get
      tags:
      - Api
      summary: GET /
      x-source: https://docs.refold.ai/v3/embedded/quickstart
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl you can run from a terminal, then move into your server. \n Every API call uses the base URL https://app.refold.ai . Calls\
          \ in this guide send your API key in the x-api-key header, and account-scoped calls also send the customer’s linked_account_id as a\
          \ header. Generating the Connect portal URL is the exception: it authenticates with the account’s session token. Never expose your API\
          \ key in the"
  /api/v2/integration-schema/hubspot/actions:
    get:
      operationId: get_api_v2_integration_schema_hubspot_actions
      tags:
      - Api
      summary: GET /api/v2/integration-schema/hubspot/actions
      x-source: https://docs.refold.ai/v3/embedded/quickstart
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl curl https://app.refold.ai/api/v2/integration-schema/hubspot/actions  -H \"x-api-key: $REFOLD_API_KEY \"  -H \"linked_account_id:\
          \ demo-user-1\" \n Then execute it. Here you create a contact in the customer’s HubSpot: "
  /api/v2/integration-schema/hubspot/actions/create_contact/execute:
    get:
      operationId: get_api_v2_integration_schema_hubspot_actions_create_contact_execute
      tags:
      - Api
      summary: Read and Write Data - Refold
      description: Executes the write action create_contact for HubSpot.
      x-source: https://docs.refold.ai/v3/embedded/use-cases/read-write
      parameters:
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
        description: API key
      - name: linked_account_id
        in: header
        required: true
        schema:
          type: string
        description: Customer's linked account ID
      - name: Content-Type
        in: header
        required: true
        schema:
          type: string
        description: application/json
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV2IntegrationSchemaHubspotActionsCreateContactExecuteR'
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_v2_integration_schema_hubspot_actions_create_contact_execute
      tags:
      - Api
      summary: POST /api/v2/integration-schema/hubspot/actions/create_contact/execute
      x-source: https://docs.refold.ai/v3/embedded/quickstart
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV2IntegrationSchemaHubspotActionsCreateContactExecute'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl curl -X POST https://app.refold.ai/api/v2/integration-schema/hubspot/actions/create_contact/execute  -H \"x-api-key: $REFOLD_API_KEY\
          \ \"  -H \"linked_account_id: demo-user-1\"  -H \"Content-Type: application/json\"  -d '{ \n \"email\": \" [email protected] \", \n\
          \ \"firstname\": \"Jane\", \n \"lastname\": \"Doe\" \n }' \n Output { \n \"node_status\" : \"Success\" , \n \"http_status\" : 201 ,\
          \ \n \"data\" : { \n \"id\" : \"1510721\" ,"
  /api/v2/integration-schema/hubspot/actions/get_contact/execute:
    get:
      operationId: get_api_v2_integration_schema_hubspot_actions_get_contact_execute
      tags:
      - Api
      summary: Read and Write Data - Refold
      description: Executes the read action get_contact for HubSpot.
      x-source: https://docs.refold.ai/v3/embedded/use-cases/read-write
      parameters:
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
        description: API key
      - name: linked_account_id
        in: header
        required: true
        schema:
          type: string
        description: Customer's linked account ID
      - name: Content-Type
        in: header
        required: true
        schema:
          type: string
        description: application/json
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV2IntegrationSchemaHubspotActionsGetContactExecuteResp'
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_v2_integration_schema_hubspot_actions_get_contact_execute
      tags:
      - Api
      summary: POST /api/v2/integration-schema/hubspot/actions/get_contact/execute
      x-source: https://docs.refold.ai/v3/embedded/ship-operate/testing
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV2IntegrationSchemaHubspotActionsGetContactExecuteReq'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl or SDK call from your backend. Workflow Triggers, nodes, branching, and error handling resolve correctly across a full\
          \ run. The Platform workflow testing panel. End-to-end A customer can connect an app and your product reads or writes through that connection.\
          \ Your product (or the hosted flow ) plus your backend. \n This page covers testing against a test account and the customer-facing flow.\
          \ F"
  /api/v2/integration-schema/netsuite/actions:
    get:
      operationId: get_api_v2_integration_schema_netsuite_actions
      tags:
      - Api
      summary: GET /api/v2/integration-schema/netsuite/actions
      x-source: https://docs.refold.ai/v3/get-started/quickstart
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl curl https://app.refold.ai/api/v2/integration-schema/netsuite/actions  -H \"x-api-key: $REFOLD_API_KEY \"  -H \"linked_account_id:\
          \ demo-user-1\" \n Then execute a read action to fetch records. For example, Get List Of Records Invoice ( get_list_of_records_invoice\
          \ ) returns the account’s invoices: "
  /api/v2/integration-schema/netsuite/actions/get_list_of_records_invoice/execute:
    post:
      operationId: post_api_v2_integration_schema_netsuite_actions_get_list_of_records_invoice_exec
      tags:
      - Api
      summary: POST /api/v2/integration-schema/netsuite/actions/get_list_of_records_invoice/execute
      x-source: https://docs.refold.ai/v3/get-started/quickstart
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl curl -X POST https://app.refold.ai/api/v2/integration-schema/netsuite/actions/get_list_of_records_invoice/execute  -H \"\
          x-api-key: $REFOLD_API_KEY \"  -H \"linked_account_id: demo-user-1\"  -H \"Content-Type: application/json\"  -d '{}' \n Output { \n\
          \ \"node_status\" : \"Success\" , \n \"http_status\" : 200 , \n \"data\" : { \n \"items\" : [ \n { \"id\" : \"1024\" , \"tranId\" :\
          \ \"INV-1024\" , \"entity\" : \"Acme Corp\" , \"to"
  /api/v2/public/application:
    get:
      operationId: get_api_v2_public_application
      tags:
      - Api
      summary: GET /api/v2/public/application
      x-source: https://docs.refold.ai/v3/api-reference/overview
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV2PublicApplicationResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X GET https://app.refold.ai/api/v2/public/application  -H \"x-api-key: YOUR_API_KEY\"  -H \"linked_account_id: YOUR_LINKED_ACCOUNT_ID\"\
          \ \n Finding your API Key: \nNavigate to Settings > Workspace Settings > Credentials in your Refold dashboard. You can copy the API\
          \ key for either the Test or Production environment. Session Token Authentication Use session-token authentication for frontend / hosted"
  /api/v2/public/auth-schema/{slug}:
    get:
      operationId: get_api_v2_public_auth_schema_slug
      tags:
      - Api
      summary: Get Auth Schema
      description: Retrieves the authentication schema for a given application slug, including connection_fields of the auth type or grant.
      x-source: https://docs.refold.ai/v3/api-reference/javascript-sdk
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v2/public/connect-url:
    post:
      operationId: post_api_v2_public_connect_url
      tags:
      - Api
      summary: POST /api/v2/public/connect-url
      x-source: https://docs.refold.ai/v3/embedded/quickstart
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV2PublicConnectUrlRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl curl -X POST https://app.refold.ai/api/v2/public/connect-url  -H \"Authorization: Bearer $SESSION_TOKEN \"  -H \"Content-Type:\
          \ application/json\"  -d '{ \"name\": \"Demo User\" }' \n Output { \"hosted_url\" : \"https://app.refold.ai/connect/Ik7fQ2xLm9pR4sT6vX8zA1cD3eG5hJ7kN0qU2wY4bE6\"\
          \ } \n 1 Open the portal Open the hosted_url from the response in your browser. 2 Connect HubSpot Find HubSpot , click Conne"
  /api/v2/public/event/hubspot:
    post:
      operationId: post_api_v2_public_event_hubspot
      tags:
      - Api
      summary: POST /api/v2/public/event/hubspot
      x-source: https://docs.refold.ai/v3/connectors/my-app/events
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV2PublicEventHubspotRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV2PublicEventHubspotResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl curl -X POST \"https://app.refold.ai/api/v2/public/event/hubspot\"  -H \"x-api-key: $REFOLD_API_KEY \"  -H \"linked_account_id:\
          \ user_12345\"  -H \"Content-Type: application/json\"  -d '{ \n \"event\": \"New Contact Created\", \n \"payload\": { \n \"first_name\"\
          : \"Jane\", \n \"last_name\": \"Doe\", \n \"email\": \" [email protected] \" \n } \n }' \n Output { \n \"message\" : \"Webhook Fired\
          \ Success\" \n } \n With the Node.js SDK, us"
  /api/v2/public/event/trigger:
    post:
      operationId: post_api_v2_public_event_trigger
      tags:
      - Api
      summary: POST /api/v2/public/event/trigger
      x-source: https://docs.refold.ai/v3/embedded/use-cases/sync
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV2PublicEventTriggerRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl curl -X POST https://app.refold.ai/api/v2/public/event/trigger  -H \"x-api-key: $REFOLD_API_KEY \"  -H \"linked_account_id:\
          \ demo-user-1\"  -H \"slug: salesforce\"  -H \"Content-Type: application/json\"  -d '{ \n \"event\": \"Contact Updated\", \n \"payload\"\
          : { \n \"id\": \"internal-42\", \n \"first_name\": \"Jane\", \n \"last_name\": \"Doe\", \n \"email\": \" [email protected] \" \n } \n\
          \ }' \n Contact Updated is the event name th"
  /api/v2/public/linked-account:
    post:
      operationId: post_api_v2_public_linked_account
      tags:
      - Api
      summary: POST /api/v2/public/linked-account
      x-source: https://docs.refold.ai/v3/embedded/quickstart
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV2PublicLinkedAccountRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl curl -X POST https://app.refold.ai/api/v2/public/linked-account  -H \"x-api-key: $REFOLD_API_KEY \"  -H \"Content-Type:\
          \ application/json\"  -d '{ \n \"linked_account_id\": \"demo-user-1\", \n \"name\": \"Demo User\" \n }' \n Output { \n \"_id\" : \"\
          6a1b2c3d4e5f6a7b8c9d0e1f\" , \n \"associated_org\" : \"6a0b1c2d3e4f5a6b7c8d9e0f\" , \n \"account_id\" : \"demo-user-1\" , \n \"environment\"\
          \ : \"test\" , \n \"name\" : \"Demo User\" , \n \""
  /api/v2/public/session-token:
    post:
      operationId: post_api_v2_public_session_token
      tags:
      - Api
      summary: POST /api/v2/public/session-token
      x-source: https://docs.refold.ai/v3/embedded/quickstart
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV2PublicSessionTokenRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl curl -X POST https://app.refold.ai/api/v2/public/session-token  -H \"x-api-key: $REFOLD_API_KEY \"  -H \"Content-Type:\
          \ application/json\"  -d '{ \"linked_account_id\": \"demo-user-1\" }' \n export SESSION_TOKEN = \"<token from the response>\" \n Then\
          \ generate the connect URL with the session token as a Bearer token: "
  /api/v2/public/webhook:
    post:
      operationId: post_api_v2_public_webhook
      tags:
      - Api
      summary: POST /api/v2/public/webhook
      x-source: https://docs.refold.ai/v3/connectors/my-app/webhooks
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV2PublicWebhookRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl curl -X POST https://app.refold.ai/api/v2/public/webhook  -H \"x-api-key: $REFOLD_API_KEY \"  -H \"Content-Type: application/json\"\
          \  -d '{ \n \"webhook_url\": \"https://your-app.com/webhooks/refold\", \n \"webhook_events\": [\"Connection Created\", \"Workflow Errored\"\
          ] \n }' \n See Create Webhook for the full request and response. \n  Handle events in your backend \n 1 Expose an HTTPS endpoint Stand\
          \ up a route"
  /api/v2/public/workflow/enabled:
    get:
      operationId: get_api_v2_public_workflow_enabled
      tags:
      - Api
      summary: List Enabled Workflows.
      x-source: https://docs.refold.ai/v3/api-reference/overview
      parameters:
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
        description: Bearer token using your session token.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v2/public/workflow/{workflowid}/execute:
    post:
      operationId: post_api_v2_public_workflow_workflowid_execute
      tags:
      - Api
      summary: POST /api/v2/public/workflow/{workflowId}/execute
      x-source: https://docs.refold.ai/v3/get-started/quickstart
      parameters:
      - name: workflowid
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV2PublicWorkflowWorkflowidExecuteRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl curl -X POST https://app.refold.ai/api/v2/public/workflow/YOUR_WORKFLOW_ID/execute  -H \"x-api-key: $REFOLD_API_KEY \"\
          \  -H \"linked_account_id: demo-user-1\"  -H \"slug: netsuite\"  -H \"Content-Type: application/json\"  -d '{ \"invoice_id\": \"1024\"\
          \ }' \n The request body is the workflow’s trigger payload as-is, so send the fields directly rather than wrapping them in a payload\
          \ object. \n Output { \n \"exe"
components:
  schemas:
    GetApiV2IntegrationSchemaHubspotActionsCreateContactExecuteR:
      type: object
      properties:
        node_status:
          type: string
          description: Success or Errored
        http_status:
          type: integer
          description: HTTP status from the app
        data:
          type: object
          description: Created contact data
    PostApiV2IntegrationSchemaHubspotActionsCreateContactExecute:
      type: object
      properties:
        email:
          type: string
        firstname:
          type: string
        lastname:
          type: string
    GetApiV2IntegrationSchemaHubspotActionsGetContactExecuteResp:
      type: object
      properties:
        node_status:
          type: string
          description: Success or Errored
        http_status:
          type: integer
          description: HTTP status from the app
        data:
          type: object
          description: App native result data
    PostApiV2IntegrationSchemaHubspotActionsGetContactExecuteReq:
      type: object
      properties:
        contact_id:
          type: string
    GetApiV2PublicApplicationResponse:
      type: object
      properties:
        status_code:
          type: integer
        http_error_type:
          type: string
        error:
          type: string
        message:
          type: string
    PostApiV2PublicConnectUrlRequest:
      type: object
      properties:
        name:
          type: string
    PostApiV2PublicEventHubspotRequest:
      type: object
      properties:
        event:
          type: string
        payload:
          type: object
          properties:
            first_name:
              type: string
            last_name:
              type: string
            email:
              type: string
    PostApiV2PublicEventHubspotResponse:
      type: object
      properties:
        linked_account_id:
          type: string
        event:
          type: string
        slug:
          type: string
        payload:
          type: object
          properties:
            first_name:
              type: string
            last_name:
              type: string
            email:
              type: string
    PostApiV2PublicEventTriggerRequest:
      type: object
      properties:
        event:
          type: string
        payload:
          type: object
          properties:
            id:
              type: string
            first_name:
              type: string
            last_name:
              type: string
            email:
              type: string
    PostApiV2PublicLinkedAccountRequest:
      type: object
      properties:
        linked_account_id:
          type: string
        name:
          type: string
    PostApiV2PublicSessionTokenRequest:
      type: object
      properties:
        linked_account_id:
          type: string
    PostApiV2PublicWebhookRequest:
      type: object
      properties:
        webhook_url:
          type: string
        webhook_events:
          type: array
          items:
            type: string
    PostApiV2PublicWorkflowWorkflowidExecuteRequest:
      type: object
      properties:
        invoice_id:
          type: string
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
security:
- apiKey: []
tags:
- name: Api