Logto Connector factories API
Connector factories are used to create connectors. They can be treated as preconfigured templates for connectors.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/logto-connector-factories-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
OpenAPI Specification
openapi: 3.0.1
info:
title: Logto API references Account center Connector factories API
description: 'API references for Logto services.
Note: The documentation is for Logto Cloud. If you are using Logto OSS, please refer to the response of `/api/swagger.json` endpoint on your Logto instance.'
version: Cloud
servers:
- url: https://[tenant_id].logto.app/
description: Logto endpoint address.
security:
- OAuth2:
- all
tags:
- name: Connector factories
description: Connector factories are used to create connectors. They can be treated as preconfigured templates for connectors.
paths:
/api/connector-factories:
get:
operationId: ListConnectorFactories
tags:
- Connector factories
parameters: []
responses:
'200':
description: An array of connector factories.
content:
application/json:
schema:
type: array
items:
type: object
required:
- type
- id
- target
- name
- description
- logo
- logoDark
- readme
- platform
properties:
type:
type: string
enum:
- Email
- Sms
- Social
isDemo:
type: boolean
id:
type: string
target:
type: string
name:
type: object
description: Validator function
description:
type: object
description: Validator function
logo:
type: string
logoDark:
type: string
nullable: true
readme:
type: string
configTemplate:
type: string
formItems:
type: array
items:
oneOf:
- type: object
required:
- type
- selectItems
- key
- label
properties:
type:
type: string
format: '"Select"'
selectItems:
type: array
items:
type: object
required:
- value
- title
properties:
value:
type: string
title:
type: string
key:
type: string
label:
type: string
placeholder:
type: string
required:
type: boolean
defaultValue:
example: {}
showConditions:
type: array
items:
type: object
required:
- targetKey
properties:
targetKey:
type: string
expectValue:
example: {}
description:
type: string
tooltip:
type: string
isConfidential:
type: boolean
isDevFeature:
type: boolean
- type: object
required:
- type
- selectItems
- key
- label
properties:
type:
type: string
format: '"MultiSelect"'
selectItems:
type: array
items:
type: object
required:
- value
properties:
value:
type: string
key:
type: string
label:
type: string
placeholder:
type: string
required:
type: boolean
defaultValue:
example: {}
showConditions:
type: array
items:
type: object
required:
- targetKey
properties:
targetKey:
type: string
expectValue:
example: {}
description:
type: string
tooltip:
type: string
isConfidential:
type: boolean
isDevFeature:
type: boolean
- type: object
required:
- type
- key
- label
properties:
type:
type: string
enum:
- Text
- Number
- MultilineText
- Switch
- Json
key:
type: string
label:
type: string
placeholder:
type: string
required:
type: boolean
defaultValue:
example: {}
showConditions:
type: array
items:
type: object
required:
- targetKey
properties:
targetKey:
type: string
expectValue:
example: {}
description:
type: string
tooltip:
type: string
isConfidential:
type: boolean
isDevFeature:
type: boolean
customData:
type: object
additionalProperties:
example: {}
fromEmail:
type: string
platform:
type: string
enum:
- Native
- Universal
- Web
nullable: true
isStandard:
type: boolean
isTokenStorageSupported:
type: boolean
'401':
description: Unauthorized
'403':
description: Forbidden
summary: Get connector factories
description: Get all connector factories data available in Logto.
/api/connector-factories/{id}:
get:
operationId: GetConnectorFactory
tags:
- Connector factories
parameters:
- $ref: '#/components/parameters/connectorFactoryId-root'
responses:
'200':
description: Connector factory data.
content:
application/json:
schema:
type: object
required:
- type
- id
- target
- name
- description
- logo
- logoDark
- readme
- platform
properties:
type:
type: string
enum:
- Email
- Sms
- Social
isDemo:
type: boolean
id:
type: string
target:
type: string
name:
type: object
description: Validator function
description:
type: object
description: Validator function
logo:
type: string
logoDark:
type: string
nullable: true
readme:
type: string
configTemplate:
type: string
formItems:
type: array
items:
oneOf:
- type: object
required:
- type
- selectItems
- key
- label
properties:
type:
type: string
format: '"Select"'
selectItems:
type: array
items:
type: object
required:
- value
- title
properties:
value:
type: string
title:
type: string
key:
type: string
label:
type: string
placeholder:
type: string
required:
type: boolean
defaultValue:
example: {}
showConditions:
type: array
items:
type: object
required:
- targetKey
properties:
targetKey:
type: string
expectValue:
example: {}
description:
type: string
tooltip:
type: string
isConfidential:
type: boolean
isDevFeature:
type: boolean
- type: object
required:
- type
- selectItems
- key
- label
properties:
type:
type: string
format: '"MultiSelect"'
selectItems:
type: array
items:
type: object
required:
- value
properties:
value:
type: string
key:
type: string
label:
type: string
placeholder:
type: string
required:
type: boolean
defaultValue:
example: {}
showConditions:
type: array
items:
type: object
required:
- targetKey
properties:
targetKey:
type: string
expectValue:
example: {}
description:
type: string
tooltip:
type: string
isConfidential:
type: boolean
isDevFeature:
type: boolean
- type: object
required:
- type
- key
- label
properties:
type:
type: string
enum:
- Text
- Number
- MultilineText
- Switch
- Json
key:
type: string
label:
type: string
placeholder:
type: string
required:
type: boolean
defaultValue:
example: {}
showConditions:
type: array
items:
type: object
required:
- targetKey
properties:
targetKey:
type: string
expectValue:
example: {}
description:
type: string
tooltip:
type: string
isConfidential:
type: boolean
isDevFeature:
type: boolean
customData:
type: object
additionalProperties:
example: {}
fromEmail:
type: string
platform:
type: string
enum:
- Native
- Universal
- Web
nullable: true
isStandard:
type: boolean
isTokenStorageSupported:
type: boolean
'400':
description: Bad Request
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Connector factory not found.
summary: Get connector factory
description: Get connector factory by the given ID.
components:
parameters:
connectorFactoryId-root:
in: path
description: The unique identifier of the connector factory.
required: true
schema:
type: string
name: id
securitySchemes:
OAuth2:
type: oauth2
description: "Logto Management API is a comprehensive set of REST APIs that gives you the full control over Logto to suit your product needs and tech stack. To see the full guide on Management API interactions, visit [Interact with Management API](https://docs.logto.io/docs/recipes/interact-with-management-api/).\n\n### Get started\n\nThe API follows the same authentication principles as other API resources in Logto, with some slight differences. To use Logto Management API:\n\n1. A machine-to-machine (M2M) application needs to be created.\n2. A machine-to-machine (M2M) role with Management API permission `all` needs to be assigned to the application.\n\nOnce you have them set up, you can use the `client_credentials` grant type to fetch an access token and use it to authenticate your requests to the Logto Management API.\n\n### Fetch an access token\n\nTo fetch an access token, you need to make a `POST` request to the `/oidc/token` endpoint of your Logto tenant.\n\nFor Logto Cloud users, the base URL is your Logto endpoint, i.e. `https://[tenant-id].logto.app`. The tenant ID can be found in the following places:\n\n- The first path segment of the URL when you are signed in to Logto Cloud. For example, if the URL is `https://cloud.logto.io/foo/get-started`, the tenant ID is `foo`.\n- In the \"Settings\" tab of Logto Cloud.\n\nThe request should follow the OAuth 2.0 [client credentials](https://datatracker.ietf.org/doc/html/rfc6749#section-4.4) grant type. Here is a non-normative example of how to fetch an access token:\n\n```bash\ncurl --location \\\n --request POST 'https://[tenant-id].logto.app/oidc/token' \\\n --header 'Content-Type: application/x-www-form-urlencoded' \\\n --data-urlencode 'grant_type=client_credentials' \\\n --data-urlencode 'client_id=[app-id]' \\\n --data-urlencode 'client_secret=[app-secret]' \\\n --data-urlencode 'resource=https://[tenant-id].logto.app/api' \\\n --data-urlencode 'scope=all'\n```\n\nReplace `[tenant-id]`, `[app-id]`, and `[app-secret]` with your Logto tenant ID, application ID, and application secret, respectively.\n\nThe response will be like:\n\n```json\n{\n \"access_token\": \"eyJhbG...2g\", // Use this value for accessing the Logto Management API\n \"expires_in\": 3600, // Token expiration in seconds\n \"token_type\": \"Bearer\", // Token type for your request when using the access token\n \"scope\": \"all\" // Scope `all` for Logto Management API\n}\n```\n\n### Use the access token\n\nOnce you have the access token, you can use it to authenticate your requests to the Logto Management API. The access token should be included in the `Authorization` header of your requests with the `Bearer` authentication scheme.\n\nHere is an example of how to list the first page of users in your Logto tenant:\n\n```bash\ncurl --location \\\n --request GET 'https://[tenant-id].logto.app/api/users' \\\n --header 'Authorization: Bearer eyJhbG...2g'\n```\n\nReplace `[tenant-id]` with your Logto tenant ID and `eyJhbG...2g` with the access token you fetched earlier."
flows:
clientCredentials:
tokenUrl: /oidc/token
scopes:
all: All scopes