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

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Create Dispute Evidence Text

> Uploads text to use as evidence for a dispute challenge.

`square.createDisputeEvidenceText` uploads text to use as evidence for a dispute challenge.

## Example

```ts automations/square-create-dispute-evidence-text.automation.ts theme={null}
import { automation, onDashboardRun } from "automate.ax"
import { square } from "automate.ax/square"

export default automation("Create Square Dispute Evidence Text", () => {
  onDashboardRun({ title: "Create Square Dispute Evidence Text" })

  square.createDisputeEvidenceText({
    disputeId: "dispute_id",
    idempotencyKey: "ed3ee3933d946f1514d505d173c82648",
    evidenceType: "TRACKING_NUMBER",
    evidenceText: "1Z8888888888888888",
  })
})
```

## Inputs

Every input accepts a compatible signal. It requires `DISPUTES_WRITE`.

| Field            | Type                         | Required | Default | Description                                                                                                                                       |
| ---------------- | ---------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `disputeId`      | `string`                     | Yes      | —       | The ID of the dispute for which you want to upload evidence.                                                                                      |
| `idempotencyKey` | `string`                     | Yes      | —       | A unique key identifying the request. For more information, see [Idempotency](https://developer.squareup.com/docs/working-with-apis/idempotency). |
| `evidenceType`   | `Square.DisputeEvidenceType` | No       | —       | The type of evidence you are uploading. See [DisputeEvidenceType](#type-disputeevidencetype) for possible values                                  |
| `evidenceText`   | `string`                     | Yes      | —       | The evidence string.                                                                                                                              |

Use the official [CreateDisputeEvidenceText reference](https://developer.squareup.com/reference/square/disputes-api/create-dispute-evidence-text) for provider field semantics and limits.

## Output

Returns the official `Square.CreateDisputeEvidenceTextResponse` response as a codec-safe object. Square integer money amounts remain `bigint` values.