Skip to content
For LLMsView as Markdown·

Persona

Identity verification platform with inquiry workflows, document checks, and GDPR compliance.

DetailValue
CategoryiGaming
Base URLhttps://api.withpersona.com
AuthenticationBearer Token
Endpoints9
Connector keypersona

Using Persona in a workflow

  1. Go to Connections and click New Connection.
  2. Pick Persona from the marketplace.
  3. Enter your credentials (see Authentication above for what's expected).
  4. In a workflow, drop an API Call node and select this connection.
  5. Pick the operation you need from the Operation dropdown — the full list is below.

Available endpoints

EndpointSummary
POST /api/v1/inquiriesCreate inquiry
GET /api/v1/inquiries/{id}Get inquiry
PATCH /api/v1/inquiries/{id}Update inquiry
POST /api/v1/inquiries/{id}/approveApprove
POST /api/v1/inquiries/{id}/declineDecline
DELETE /api/v1/inquiries/{id}Redact (GDPR)
GET /api/v1/verifications/{id}Get verification
GET /api/v1/accounts/{id}Get account
GET /api/v1/reports/{id}Get report

Each endpoint is documented in full below. Use the outline on the right to jump to one.

POST /api/v1/inquiries

Create inquiry

DetailValue
Operation IDkyc.createInquiry
MethodPOST
Path/api/v1/inquiries

Parameters

No parameters.

Request Body

FieldType
dataobject

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Persona connection from the Connection dropdown.
  3. In the Operation dropdown, select kyc.createInquiry.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Persona API reference.

GET /api/v1/inquiries/{id}

Get inquiry

DetailValue
Operation IDkyc.getInquiry
MethodGET
Path/api/v1/inquiries/{id}

Parameters

NameLocationTypeRequired
idpathstringYes

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Persona connection from the Connection dropdown.
  3. In the Operation dropdown, select kyc.getInquiry.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Persona API reference.

PATCH /api/v1/inquiries/{id}

Update inquiry

DetailValue
Operation IDkyc.updateInquiry
MethodPATCH
Path/api/v1/inquiries/{id}

Parameters

NameLocationTypeRequired
idpathstringYes

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Persona connection from the Connection dropdown.
  3. In the Operation dropdown, select kyc.updateInquiry.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Persona API reference.

POST /api/v1/inquiries/{id}/approve

Approve

DetailValue
Operation IDkyc.approveInquiry
MethodPOST
Path/api/v1/inquiries/{id}/approve

Parameters

NameLocationTypeRequired
idpathstringYes

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Persona connection from the Connection dropdown.
  3. In the Operation dropdown, select kyc.approveInquiry.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Persona API reference.

POST /api/v1/inquiries/{id}/decline

Decline

DetailValue
Operation IDkyc.declineInquiry
MethodPOST
Path/api/v1/inquiries/{id}/decline

Parameters

NameLocationTypeRequired
idpathstringYes

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Persona connection from the Connection dropdown.
  3. In the Operation dropdown, select kyc.declineInquiry.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Persona API reference.

DELETE /api/v1/inquiries/{id}

Redact (GDPR)

DetailValue
Operation IDkyc.redactInquiry
MethodDELETE
Path/api/v1/inquiries/{id}

Parameters

NameLocationTypeRequired
idpathstringYes

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Persona connection from the Connection dropdown.
  3. In the Operation dropdown, select kyc.redactInquiry.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Persona API reference.

GET /api/v1/verifications/{id}

Get verification

DetailValue
Operation IDkyc.getVerification
MethodGET
Path/api/v1/verifications/{id}

Parameters

NameLocationTypeRequired
idpathstringYes

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Persona connection from the Connection dropdown.
  3. In the Operation dropdown, select kyc.getVerification.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Persona API reference.

GET /api/v1/accounts/{id}

Get account

DetailValue
Operation IDkyc.getAccount
MethodGET
Path/api/v1/accounts/{id}

Parameters

NameLocationTypeRequired
idpathstringYes

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Persona connection from the Connection dropdown.
  3. In the Operation dropdown, select kyc.getAccount.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Persona API reference.

GET /api/v1/reports/{id}

Get report

DetailValue
Operation IDkyc.getReport
MethodGET
Path/api/v1/reports/{id}

Parameters

NameLocationTypeRequired
idpathstringYes

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Persona connection from the Connection dropdown.
  3. In the Operation dropdown, select kyc.getReport.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Persona API reference.