POST///
Create a dispute case event with evidence.
Path parameter
| Fields | Description |
|---|---|
| case_token string Required | Unique identifier of the dispute case, generated by Marqeta. Allowable Values: 36 char max |
Body field details
| Fields | Description |
|---|---|
| name string Required | Name of the event. Allowable Values: 255 char max |
| category string Optional | Category to which the event belongs. Allowable Values: REG_E |
| event_date string Optional | Date and time of the event, in UTC. Allowable Values: Format: yyyy-MM-dd’T’HH:mm:ssZ |
| created_by string Required | User who created the event. Allowable Values: 255 char max |
| evidence_details object Required | Details of the evidence for the dispute. Allowable Values: pc_amount, webhook_id, notes, evidences |
| evidence_details.pc_amount string Required | Amount of provisional credit granted or reversed. Allowable Values: Any positive decimal greater than zero, written as a string |
| evidence_details.webhook_id string Optional | Marqeta-generated identifier of the webhook associated with the case event. Allowable Values: 255 char max |
| evidence_details.notes string Optional | Notes about the evidence. Allowable Values: 255 char max |
| evidence_details.evidences array of objects Required | One or more objects containing evidence about the dispute. Allowable Values: Valid array of evidences objects |
| evidence_details.evidences[].evidence string Required | Text containing evidence or evidence identifiers (such as a case document ID). Allowable Values: 255 char max |
| evidence_details.evidences[].evidence_type string Required | Type of evidence submitted (ID, text content, or other). Allowable Values: COMMUNICATION_CONTENT, EXTERNAL_TRANSACTION_ID, CRM_ID, CASE_DOCUMENT_ID, OTHERFor ProgramGrantedProvisionalCredit or ProgramRevertedProvisionalCredit events, at least one submitted evidence_type must be EXTERNAL_TRANSACTION_ID.For ProgramCommunicatedGrantingProvisionalCredit or ProgramCommunicatedRevertingProvisionalCredit events, at least one submitted evidence_type must be COMMUNICATION_CONTENT, CRM_ID, or CASE_DOCUMENT_ID. |
Response body
| Fields | Description |
|---|---|
| token string Returned | Unique identifier of the event, generated by Marqeta. Allowable Values: 36 char max |
| case_token string Returned | Unique identifier of the associated case that triggered this event, generated by Marqeta. Allowable Values: 36 char max |
| name string Returned | Name of the event. Allowable Values: 255 char max |
| category string Conditionally returned | Category to which the event belongs. Allowable Values: REG_E |
| created_by string Returned | User who created the event. Allowable Values: 255 char max |
| event_date string Conditionally returned | Date and time of the event, in UTC. Allowable Values: Format: yyyy-MM-dd’T’HH:mm:ssZ |
| created_time string Returned | Date and time when the event was created, in UTC. Allowable Values: Format: yyyy-MM-dd’T’HH:mm:ssZ |
Sample request
JSON
{
"name": "ProgramCommunicatedGrantingProvisionalCredit",
"category": "REG_E",
"created_by": "agent_123",
"event_date": "2026-01-15T10:30:00Z",
"evidence_details": {
"pc_amount": "150.00",
"webhook_id": "webhook_789",
"notes": "Customer provided receipt",
"evidences": [
{
"evidence": "crm_case_12345",
"evidence_type": "CRM_ID"
},
{
"evidence": "evidence 555",
"evidence_type": "COMMUNICATION_CONTENT"
}
]
}
}
Sample response
JSON
{
"token": "event_xyz789abc123",
"case_token": "case_abc123def456",
"name": "ProgramCommunicatedGrantingProvisionalCredit",
"category": "REG_E",
"event_date": "2026-01-15T10:30:00Z",
"created_by": "agent_123",
"created_time": "2026-01-15T10:30:15.123Z"
}