Mercoa organization > notification-configuration API
The organization > notification-configuration API from Mercoa — 2 operation(s) for organization > notification-configuration.
The organization > notification-configuration API from Mercoa — 2 operation(s) for organization > notification-configuration.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/mercoa:mercoa-organization-notification-configuration-api"
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.
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: 3.2.0
info:
title: Reference organization > notification-configuration API
version: 1.0.0
servers:
- url: https://api.mercoa.com
description: Production
tags:
- name: organization > notification-configuration
paths:
/organization/notification-configurations:
get:
operationId: organization_notificationConfiguration_getAll
summary: Get All
description: Retrieve all notification configurations
tags:
- organization > notification-configuration
responses:
'200':
description: Response with status 200
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/organizationTypes_NotificationConfigurationResponse'
'400':
description: Error response with status 400
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- BadRequest
content:
type: string
required:
- errorName
- content
'401':
description: Error response with status 401
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unauthorized
content:
type: string
required:
- errorName
- content
'403':
description: Error response with status 403
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Forbidden
content:
type: string
required:
- errorName
- content
'404':
description: Error response with status 404
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- NotFound
content:
type: string
required:
- errorName
- content
'409':
description: Error response with status 409
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Conflict
content:
type: string
required:
- errorName
- content
'500':
description: Error response with status 500
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- InternalServerError
content:
type: string
required:
- errorName
- content
'501':
description: Error response with status 501
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unimplemented
content:
type: string
required:
- errorName
- content
security:
- default: []
/organization/notification-configuration/{notificationType}:
get:
operationId: organization_notificationConfiguration_get
summary: Get
description: Retrieve notification configuration for this notification type
tags:
- organization > notification-configuration
parameters:
- name: notificationType
in: path
required: true
schema:
$ref: '#/components/schemas/entityTypes_NotificationType'
responses:
'200':
description: Response with status 200
content:
application/json:
schema:
$ref: '#/components/schemas/organizationTypes_NotificationConfigurationResponse'
'400':
description: Error response with status 400
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- BadRequest
content:
type: string
required:
- errorName
- content
'401':
description: Error response with status 401
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unauthorized
content:
type: string
required:
- errorName
- content
'403':
description: Error response with status 403
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Forbidden
content:
type: string
required:
- errorName
- content
'404':
description: Error response with status 404
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- NotFound
content:
type: string
required:
- errorName
- content
'409':
description: Error response with status 409
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Conflict
content:
type: string
required:
- errorName
- content
'500':
description: Error response with status 500
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- InternalServerError
content:
type: string
required:
- errorName
- content
'501':
description: Error response with status 501
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unimplemented
content:
type: string
required:
- errorName
- content
security:
- default: []
post:
operationId: organization_notificationConfiguration_update
summary: Update
description: Update notification configuration for this notification type
tags:
- organization > notification-configuration
parameters:
- name: notificationType
in: path
required: true
schema:
$ref: '#/components/schemas/entityTypes_NotificationType'
responses:
'200':
description: Response with status 200
content:
application/json:
schema:
$ref: '#/components/schemas/organizationTypes_NotificationConfigurationResponse'
'400':
description: Error response with status 400
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- BadRequest
content:
type: string
required:
- errorName
- content
'401':
description: Error response with status 401
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unauthorized
content:
type: string
required:
- errorName
- content
'403':
description: Error response with status 403
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Forbidden
content:
type: string
required:
- errorName
- content
'404':
description: Error response with status 404
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- NotFound
content:
type: string
required:
- errorName
- content
'409':
description: Error response with status 409
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Conflict
content:
type: string
required:
- errorName
- content
'500':
description: Error response with status 500
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- InternalServerError
content:
type: string
required:
- errorName
- content
'501':
description: Error response with status 501
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unimplemented
content:
type: string
required:
- errorName
- content
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/organizationTypes_NotificationConfigurationRequest'
security:
- default: []
delete:
operationId: organization_notificationConfiguration_reset
summary: Reset
description: Reset notification configuration for this notification type
tags:
- organization > notification-configuration
parameters:
- name: notificationType
in: path
required: true
schema:
$ref: '#/components/schemas/entityTypes_NotificationType'
responses:
'200':
description: Successful response
'400':
description: Error response with status 400
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- BadRequest
content:
type: string
required:
- errorName
- content
'401':
description: Error response with status 401
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unauthorized
content:
type: string
required:
- errorName
- content
'403':
description: Error response with status 403
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Forbidden
content:
type: string
required:
- errorName
- content
'404':
description: Error response with status 404
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- NotFound
content:
type: string
required:
- errorName
- content
'409':
description: Error response with status 409
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Conflict
content:
type: string
required:
- errorName
- content
'500':
description: Error response with status 500
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- InternalServerError
content:
type: string
required:
- errorName
- content
'501':
description: Error response with status 501
content:
application/json:
schema:
type: object
properties:
errorName:
type: string
enum:
- Unimplemented
content:
type: string
required:
- errorName
- content
security:
- default: []
components:
schemas:
organizationTypes_NotificationConfigurationRequest:
oneOf:
- type: object
properties:
notificationType:
type: string
enum:
- invoice
description: 'Discriminator value: invoice'
url:
type: string
description: The URL that the email will link to.
subject:
type: string
description: The subject of the email. If not provided, the default subject will be used.
required:
- notificationType
- url
discriminator:
propertyName: notificationType
title: NotificationConfigurationRequest
organizationTypes_NotificationConfigurationResponse:
oneOf:
- type: object
properties:
notificationType:
type: string
enum:
- invoice
description: 'Discriminator value: invoice'
url:
type: string
description: The URL that the email will link to.
subject:
type: string
description: The subject of the email. If not provided, the default subject will be used.
type:
$ref: '#/components/schemas/entityTypes_NotificationType'
required:
- notificationType
- url
- type
discriminator:
propertyName: notificationType
title: NotificationConfigurationResponse
entityTypes_NotificationType:
type: string
enum:
- INVOICE_APPROVAL_NEEDED
- INVOICE_APPROVED
- INVOICE_REJECTED
- INVOICE_SCHEDULED
- INVOICE_PENDING
- INVOICE_PAID
- INVOICE_CANCELED
- INVOICE_CREATED
- INVOICE_EMAILED
- INVOICE_FAILED
- COUNTERPARTY_ONBOARDING_COMPLETED
title: NotificationType
securitySchemes:
default:
type: http
scheme: bearer