---
title: "Create PayTo Agreement"
method: POST
path: "/agreements/{agreement_uuid}/create"
tags: ["PayTo Agreements"]
---

# Create PayTo Agreement

`POST /agreements/{agreement_uuid}/create`

This operation creates the agreement with NPPA and hence must be invoked only after validating the agreement via the “Validate PayTo Agreement” operation.

 It should be invoked immediately once the agreement has been validated successfully and resolved PayID details are confirmed with the user.

 Agreement Creation will be successful only if it is performed within 5 minutes post successful validation.

 Post successful creation, agreement id (generated by NPPA) which uniquely identifies the agreement will be notified. 

 Note - AUPM agreements will be ACTIVE only post debtor authorization. By default (if custom expiry duration is not provided via response_requested_by field), debtor will have 5 days to authorise the agreement, post which the authorization request will expire automatically. The agreement will be marked as CANCELLED after the 6th day if not CANCELLED automatically by the payer institution after the 5th day.
 MGCR agreements will be ACTIVE immediately post creation however, payments can be initiated only after 5 calendar days.

## Path parameters

- `agreement_uuid` string, required

## Response `202`

Accepted

- CreateAgreementResponse
  - `agreement_uuid` string — Agreement uuid
  - `status` string — Status of the create agreement request.
  - `created_at` string — creation date.
  - `updated_at` string — modification date.

## Other responses

- `400` — Bad Request <table><tr><td><b>Error Code</b></td><td><b>Error Message</b></td></tr><tr><td>PAYT-ERR-2102</td><td>Invalid format for url param: agreement_uuid.</td></tr></table>
- `401` — Unauthorised <table><tr><td><b>Error Code</b></td><td><b>Error Message</b></td></tr><tr><td>PAYT-ERR-1000</td><td>Invalid or missing authorisation token.</td></tr></table>
- `403` — Forbidden <table><tr><td><b>Error Code</b></td><td><b>Error Message</b></td></tr><tr><td>PAYT-ERR-1001</td><td>PayTo feature not available.</td></tr><tr><td>PAYT-ERR-1002</td><td>Request rejected: User associated with the agreement is not active.</td></tr></table>
- `404` — Not Found <table><tr><td><b>Error Code</b></td><td><b>Error Message</b></td></tr><tr><td>PAYT-ERR-2100</td><td>Agreement should be in VALIDATED state for creation.</td></tr></table>
- `410` — Resource Unavailable <table><tr><td><b>Error Code</b></td><td><b>Error Message</b></td></tr><tr><td>PAYT-ERR-2101</td><td>Agreement creation is allowed only within a limited time period post validation. Please validate the agreement details again.</td></tr></table>
- `500` — Internal Server Error <table><tr><td><b>Error Code</b></td><td><b>Error Message</b></td></tr><tr><td>PAYT-ERR-1003</td><td>An error occurred processing your request. Please try again.</td></tr></table>

---

[API](https://skmtc.net/hellozai/apis/assembly-api.md) · [All operations](https://skmtc.net/hellozai/apis/assembly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hellozai/assembly-api/revisions/60b528b2e015/schema)