Secureframe Custom Integration API

This document describes the API for publishing data to a custom integration.

Operations 1

POST /custom_connections/{id}/data Publish data #

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/secureframe-custom-integration-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.

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

OpenAPI Specification

secureframe-custom-integration-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Secureframe Custom Integration API
  description: '## Introduction


    Secureframe exposes a REST API for use by customers, partners, and community developers.'
  version: '2023-10-18'
  x-logo:
    url: https://media.secureframe.com/logo-dark.svg
servers:
- url: https://api.secureframe.com
- url: https://api-uk.secureframe.com
tags:
- name: Custom Integration
  description: This document describes the API for publishing data to a custom integration.
paths:
  /custom_connections/{id}/data:
    post:
      tags:
      - Custom Integration
      operationId: customConnectionsResourceDataCreate
      parameters:
      - name: id
        description: The ID of the custom connection.
        required: true
        in: path
        schema:
          type: string
          format: uuid
      responses:
        '202':
          description: Accepted      The data is enqueued for processing.
        '400':
          description: Bad Request   The request body was not in the correct format.
        '401':
          description: Unauthorized  The Authorization header was invalid.
        '403':
          description: Forbidden     The API key provided was not authorized to push data for this custom connection.
        '404':
          description: Not Found     A custom connection could not be found for the provided ID.
      description: Publish resource data to a custom integration.
      summary: Publish data
      security:
      - header_authorization: []
      x-controller: api/custom_connections/resource_data
      x-action: create
      requestBody:
        description: request
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Models_CustomConnections_CreateResourceDataRequest'
components:
  schemas:
    Models_CustomConnections_CreateResourceDataRequest:
      type: object
      properties:
        schema_slug:
          type: string
          description: 'The slug identifying the data type this data conforms to. This is used to

            identify the schema to use for processing the data.'
          example: users
        vendor_slug:
          type: string
          description: 'The slug identifying the vendor this data should be attributed to. This

            must match the vendor configured for the connection.'
          example: acme
        resource_data:
          type: array
          items:
            type: object
          description: 'An array of objects representing the current state of a set of

            resources provided by this data source.'
          example:
          - id: '123'
            name: John Doe
            email: john.doe@example.com
          - id: '456'
            name: Jane Doe
            email: jane.doe@example.com
        partial:
          type: boolean
          description: 'If true, the data will be processed as a partial update. If set, only

            the fields that are present in the data will be updated, and any fields that

            are not present will be left unchanged. The primary ID of the resource

            must always be present in the data.'
      required:
      - schema_slug
      - vendor_slug
      - resource_data
  securitySchemes:
    header_authorization:
      type: apiKey
      name: Authorization
      in: header
x-tagGroups:
- name: Endpoints
  tags:
  - Cloud Resource
  - Cloud Resource Framework Asset Scope
  - Comment
  - Control
  - Custom Integration
  - Device
  - Device Framework Asset Scope
  - Evidence
  - File Upload
  - Framework
  - Framework Requirement
  - Integration Connection
  - Knowledge Base Answer
  - Knowledge Base Question
  - POA&M Item
  - Policy
  - Repository
  - Repository Framework Asset Scope
  - Risk
  - SSP Duty
  - SSP Duty Role
  - SSP Policy
  - SSP Report
  - SSP Report Assessment Objective
  - SSP Report Section
  - SSP Report Section Block
  - SSP Role
  - SSP Vendor
  - Security Questionnaire
  - Task
  - Test
  - Test Evidence
  - Test Export
  - Test Export Reading
  - Third Party Risk Management Vendor
  - Trust Center Request
  - User
  - User Account
  - User Evidence
  - User Security Settings
  - Vendor