Create application credential

POST

https://ah-api.merge.dev/api/v1/application-credentials/

Creates an OAuth application credential for a connector. The external_id field is optional — omit it unless you need multiple OAuth apps for the same connector (e.g. one per customer tenant).

Authentication

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

Request

This endpoint expects an object.

connector_slugstringRequired<=255 characters

Slug of the connector to create an OAuth app for.

client_idstringRequired<=255 characters

client_secretstring or nullOptional<=255 characters

external_idstring or nullOptional

oauth2_scopes_overridestring or nullOptional<=2048 characters

Space-separated OAuth scopes to request instead of the connector’s default scopes. Omit to use the connector defaults. Applies to the connector’s default OAuth option; on connectors that expose more than one OAuth option, the first option is used. A value equal to the connector’s default scopes is treated as no override and reads back as null.

Response

idstringRead-onlyformat: "uuid"

connector_slugstringRead-only

client_idstringRead-only

external_idstring or nullRead-only

is_global_defaultbooleanRead-only

created_atdatetimeRead-only

modified_atdatetimeRead-only

oauth2_scopes_overridestring or nullRead-only

$	curl -X POST https://ah-api.merge.dev/api/v1/application-credentials/ \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"connector_slug": "jira",
>	"client_id": "abc123",
>	"client_secret": "secret"
>	}'

1	{
2	"id": "3c90c3c0-6d46-4b50-8888-8dd25736052f",
3	"connector_slug": "jira",
4	"client_id": "abc123",
5	"external_id": null,
6	"is_global_default": false,
7	"created_at": "2024-01-15T10:30:00Z",
8	"modified_at": "2024-01-15T10:30:00Z",
9	"oauth2_scopes_override": null
10	}