Create Subscription

Creates a new event call back subscription

SecurityOAuth2: OAuth2Flow
Request
header Parameters
Authorization
string

OAuth bearer token (see authentication flows)

x-l2f-request-id
string

Optional Unique ID per request, useful for fault resolution/diagnosis and audit.

x-l2f-idempotency-id
string

Unique ID used to safely retry an operation. See idempotency section for more details.

Request Body schema: application/json
event_type
required
string

Subscription Event Type

Enum: "ACCOUNT_EDD_L2F" "ACCOUNT_FROZEN_L2F" "ACCOUNT_PENDING_L2F" "ACCOUNT_CLOSED" "ACCOUNT_DORMANT" "ACCOUNT_EDD" "ACCOUNT_FROZEN" "ACCOUNT_OPEN" "ACCOUNT_PENDING" "APPLICATION_CHANGE_REQUESTED" "APPLICATION_READY_FOR_SUBMISSION" "APPLICATION_APPROVED" "APPLICATION_PROCESSING" "APPLICATION_REJECTED" "APPLICATION_SUBMITTED" "COUNTERPARTY_EDD_L2F" "COUNTERPARTY_FROZEN_L2F" "COUNTERPARTY_PENDING_L2F" "COUNTERPARTY_ACTIVE" "COUNTERPARTY_CLOSED" "COUNTERPARTY_EDD" "COUNTERPARTY_FROZEN" "COUNTERPARTY_PENDING" "CUSTOMER_EDD_L2F" "CUSTOMER_FROZEN_L2F" "CUSTOMER_PENDING_L2F" "CUSTOMER_ACTIVE" "CUSTOMER_CLOSED" "CUSTOMER_EDD" "CUSTOMER_FROZEN" "CUSTOMER_PENDING" "TRANSACTION_AUTHORIZED" "TRANSACTION_CANCELLED" "TRANSACTION_PENDING" "TRANSACTION_POSTED"
callback_url
required
string

Endpoint to call on event

Responses
200

Success

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Error

post/v1/subscriptions
Request samples
application/json
{
  • "event_type": "ACCOUNT_EDD_L2F",
  • "callback_url": "string"
}
Response samples
application/json
{
  • "data": {
    }
}
© 2023 Layer2 Financial Inc. All Rights Reserved.