Export Email Resend
How to resend the download email for an existing export without regenerating the CSV file.
Introduction
When an export is generated in DJUST PAY (transaction events, supplier payouts, funding transfers, or marketplace payouts), an email with the download link is automatically sent to the requester. If this email is lost, not received, or needs to be forwarded to additional recipients, the export email resend feature allows you to resend it without regenerating the CSV file.
This is a generic endpoint that works for all export types.
Key Concepts
- No file regeneration — the resend only re-sends the notification email. The original CSV file is reused.
- Status requirement — only exports at status
READYcan have their email resent. - Recipient — the primary recipient is always the connected user (the user calling the API). This cannot be changed.
- CC recipients — the list of CC recipients can be redefined in the request body. If no body is provided, the original CC list is preserved.
Endpoint
| Action | Method | Path | OperationId | Response |
|---|---|---|---|---|
| Resend export email | POST | /v1/exports/{exportId}/resend-email | ADM-EXPORT-200 | 200 OK |
Requires dj-client and dj-api-key headers.
How It Works
flowchart LR
%% Styles (Readme)
classDef create fill:#e8f1ff,stroke:#2f6feb,stroke-width:2px,color:#0b3d91;
classDef read fill:#ede9fe,stroke:#7c3aed,stroke-width:2px,color:#1e1b4b;
classDef update fill:#e0f7fa,stroke:#06b6d4,stroke-width:2px,color:#0c4a6e;
classDef add fill:#ecfdf5,stroke:#10b981,stroke-width:2px,color:#064e3b;
classDef remove fill:#fee2e2,stroke:#ef4444,stroke-width:2px,color:#7f1d1d;
classDef decision fill:#fff4e5,stroke:#f59e0b,stroke-width:2px,color:#7a3e00;
classDef place fill:#dcfce7,stroke:#16a34a,stroke-width:2px,color:#14532d;
classDef sys fill:#f2f4f7,stroke:#475569,stroke-width:2px,color:#111827;
classDef ok fill:#ecfdf5,stroke:#10b981,stroke-width:2px,color:#064e3b;
classDef stop fill:#fee2e2,stroke:#ef4444,stroke-width:2px,color:#7f1d1d;
A["📘 Export is READY"]:::read
B["🔄 POST resend-email"]:::update
C{{"✅ Status = READY?"}}:::decision
D["📩 Email resent<br>to user + CC"]:::place
E["❌ 409 Conflict<br>Export not READY"]:::stop
F["❌ 403 Forbidden<br>Not your export"]:::stop
A --> B --> C
C -->|Yes| D
C -->|Not READY| E
C -->|Wrong owner| F
style A rx:8,ry:8
style B rx:8,ry:8
style D rx:8,ry:8
style E rx:8,ry:8
style F rx:8,ry:8
API Usage
Request
POST /v1/exports/{exportId}/resend-email
dj-client: OPERATOR
dj-api-key: {{apiKey}}
Content-Type: application/jsonRequest Body (optional)
| Field | Type | Required | Description |
|---|---|---|---|
cc | string[] | No | List of CC email addresses (max 20). Overrides the original CC list. |
If no body is provided (or the cc field is omitted), the original CC recipients are preserved.
Example — Resend with updated CC list
{
"cc": ["[email protected]", "[email protected]"]
}Example — Resend with original CC list
No body required:
POST /v1/exports/{exportId}/resend-email
dj-client: OPERATOR
dj-api-key: {{apiKey}}Response — 200 OK
The response confirms the recipients:
{
"to": "[email protected]",
"cc": ["[email protected]", "[email protected]"]
}Error Cases
| HTTP Status | Scenario |
|---|---|
403 Forbidden | The export belongs to another user |
404 Not Found | The export ID does not exist |
409 Conflict | The export is not at status READY (e.g. still PENDING, FAILED, or EXPIRED) |
For the complete list of DJUST error and warning codes, refer to the dedicated page: Error / Warning codes
Supported Export Types
This endpoint works for all DJUST PAY export types:
| Export type | Trigger endpoint |
|---|---|
| Transaction events | POST /v1/payments/transactions/export |
| Supplier payouts | POST /v1/payments/supplier-payouts/export |
| Funding transfers | POST /v1/payments/funding-transfers/export |
| Marketplace payouts | POST /v1/payments/marketplace-payouts/export |
Regardless of the export type, the resend endpoint is the same: POST /v1/exports/{exportId}/resend-email.
Best Practices
- Use resend instead of re-export — if the email was lost, resend it rather than generating a new export. This is faster and avoids unnecessary load.
- Update CC recipients as needed — the resend feature lets you add new recipients who were not included in the original export request.
- Limit CC to 20 addresses — the maximum number of CC recipients per resend is 20.
Common Mistakes
| Mistake | Consequence | How to avoid |
|---|---|---|
Resending an export that is not READY | 409 Conflict error | Check the export status before resending |
| Trying to resend another user's export | 403 Forbidden error | Only the original requester can resend the email |
| Expecting to change the primary recipient | Primary is always the connected user | Use CC to send to additional recipients |
Related Documentation
- Transactions - Export
- Supplier Payouts - Export
- Funding Transfers - Export
- Marketplace Payouts - Export
