> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a dispute case event with evidence

> Create a dispute case event with evidence.

POST/cases/\{case\_token}/events

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`, `OTHER`  For `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 JSON expandable lines wrap theme={null}
{
  "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 JSON lines wrap theme={null}
{
  "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"
}
```


## Related topics

- [Disputes Evidence Collection Overview](https://www.marqeta.com/docs/core-api/disputes-evidence-collection.md)
- [Retrieve evidence for a case event](https://www.marqeta.com/docs/core-api/disputes-evidence-collection/retrieve-case-event.md)
- [Add evidence to an existing case event](https://www.marqeta.com/docs/core-api/disputes-evidence-collection/add-existing-case-event.md)
- [Create dispute case content](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-case-content-visa/create-dispute-case-content-visa.md)
- [Create dispute case transition](https://www.marqeta.com/docs/core-api/disputes-mastercard/dispute-case-transitions-mastercard/create-dispute-case-transition-mastercard.md)