Skip to main content
POST
Submit a feature request

Authorizations

​
x-api-key
string
header
required

Headers

​
Idempotency-Key
string
required

Caller-generated unique key that lets the server safely replay this request. The original response is returned for 30 days on any retry with the same key from the same organization, with the response header Idempotency-Replayed: true. Required on every state-changing money-moving or resource-creating POST.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9_.:-]{1,128}$
Example:

"01J7B3K2X9M8N5P6Q7R8S9T0V1"

Path Parameters

​
customerId
string
required
Example:

"cus_1A2b3C4d5E6f7G8h9I0jKl"

Body

application/json
​
type
enum<string>
required

The feature being requested

Available options:
virtual_account,
crypto_wallet,
yield
​
clientReferenceId
string

Client-supplied reference for the application this feature request creates. Stored on that application and echoed on it, so GET /v2/applications?clientReferenceId= finds it again. 1-255 characters from A-Za-z, 0-9, underscore, hyphen, colon, and period — no spaces.

Pattern: ^[A-Za-z0-9_\-:.]{1,255}$
Example:

"ext-feature-001"

​
fields
object

Key-value data required by the feature's requirements

​
documentIds
string[]

Flat list of uploaded document IDs to associate with this feature request

Maximum array length: 100
Minimum string length: 1
Example:
​
asset
object

Target asset for the feature, required for some feature types

Example:

Response

The submitted feature-request application

​
id
string
required

Unique application identifier

Pattern: ^app_[0-9A-Za-z]{22}$
​
status
enum<string>
required

Current lifecycle status of the application

Available options:
pending,
processing,
approved,
rejected,
cancelled
Example:

"pending"

​
createdAt
string<date-time>
required

Timestamp when the application was created

Example:

"2026-01-15T09:30:00.000Z"

​
updatedAt
string<date-time>
required

Timestamp when the application was last modified

Example:

"2026-01-15T09:30:00.000Z"

​
type
enum<string>
required
Available options:
customer_onboarding
​
clientReferenceId
string

Client-provided identifier for cross-referencing. Omitted when the client did not supply one. 1-255 characters from A-Za-z, 0-9, underscore, hyphen, colon, and period — no spaces.

Pattern: ^[A-Za-z0-9_\-:.]{1,255}$
Example:

"ext-12345"

​
submittedAt
string<date-time>

Timestamp when the application was submitted for review. Omitted while still in progress.

Example:

"2026-01-15T09:30:00.000Z"

​
failureCode
enum<string>

Machine-readable failure code on rejected applications. Omitted on non-rejected applications.

Available options:
rejected_by_ops,
compliance_denied
​
failureMessage
string

Customer-facing failure message accompanying failureCode. Omitted on non-rejected applications.

​
resubmittable
boolean

Whether a corrected application will be considered. true: correct the data and submit a fresh application. false: the decision is final, do not resubmit. Omitted on non-rejected applications.

​
reviewStage
enum<string>

Where the review of a processing application stands. automated: Conduit's automated review is still running. operator: the automated review finished without a decision, or Conduit has an open request for information about the application. A Conduit operator owns the next step unless the request needs your answer. operator means no automated decision will come; expect a decision or a request for information from Conduit. Present only while status is processing.

Available options:
automated,
operator
​
customerId
string

Customer this onboarding application produced. Omitted while the application is still being reviewed; present after approval persists the customer row.

Pattern: ^cus_[0-9A-Za-z]{22}$
​
persons
object[]

People declared on the submission, in submit order: the owners, controlling persons and legal representatives of a business, or the one account holder of an individual. Omitted before the application carries a submission.

​
resubmissionGuidance
string

Integrator guidance for the resubmission. Present only on a rejected application whose resubmittable is true. A fixed line — display or log it, do not parse it. Omitted on non-rejected applications and on final rejections.

​
reviewQuestions
string[]

Questions to address in the resubmission. Present only on a rejected application whose resubmittable is true when Conduit asks for more information. Omitted otherwise.