---
title: "Create an ROE SAT agreement"
method: POST
path: "/roe_sat_agreements"
tags: ["ROE SAT Agreements"]
---

# Create an ROE SAT agreement

`POST /roe_sat_agreements`

## Request body

- object
  - `business_entity_id` string, required — The Business Entity the agreement is recorded under.
  - `business_number` string, required — The CRA payroll account number (BN15, e.g. 123456782RP0001) the agreement covers. Only one non-revoked agreement may cover a business number at a time.
  - `business_legal_name` string, nullable — The client's legal name as written on the letter. Defaults to the Business Entity's legal name when omitted.
  - `signer_name` string, required — The person who signed the letter on the client's behalf.
  - `signer_title` string, required — The signer's job title.
  - `signed_on` string, date, required — The date written on the signed letter.
  - `locale` 'en' | 'fr' — The language of the letter (en or fr). Defaults to the Business Entity's language when omitted.
  - `letter` string — The client's signed copy of the letter as a PDF. When omitted, a copy of the letter recording the acceptance is generated and attached automatically.

## Response `201`

Created

- object
  - `id` string — The unique identifier of the object in Nmbr.
  - `object` string — The type of the object in Nmbr (`"roe_sat_agreement"`).
  - `data` RoeSatAgreement
    - `business_entity` object
      - `id` string — The unique identifier of the object in Nmbr.
      - `object` string — The type of the object in Nmbr (`"business_entity"`).
    - `business_number` string — The CRA payroll account number (BN15) the agreement covers. ROEs issued under this number are filed with Service Canada automatically while the agreement is not revoked.
    - `business_legal_name` string — The client's legal name as written on the letter.
    - `signer_name` string — The person who signed the letter on the client's behalf.
    - `signer_title` string — The signer's job title.
    - `signed_on` string, date — The date written on the signed letter.
    - `revoked_at` string, dateTime, nullable — When the agreement was revoked. Null while the agreement is in effect.
    - `locale` 'en' | 'fr' — The language of the letter (en or fr).
    - `letter_was_uploaded` boolean — Whether the attached letter is the client's uploaded signed copy (true) or a copy generated from the recorded details (false). Download it from `/roe_sat_agreements/{id}/letter`.
    - `created_at` string, dateTime — The date and time the object was created in Nmbr.
    - `updated_at` string, dateTime — The date and time the object was last updated in Nmbr.

---

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