Skip to main content
POST
Create an ROE SAT agreement

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
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.

signer_name
string
required

The person who signed the letter on the client's behalf.

Maximum string length: 255
signer_title
string
required

The signer's job title.

Maximum string length: 255
signed_on
string<date>
required

The date written on the signed letter.

The client's legal name as written on the letter. Defaults to the Business Entity's legal name when omitted.

Maximum string length: 255
locale
enum<string>

The language of the letter (en or fr). Defaults to the Business Entity's language when omitted.

Available options:
en,
fr
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.

Maximum string length: 10240

Response

201 - application/json

Created

id
string
read-only

The unique identifier of the object in Nmbr.

object
string
read-only

The type of the object in Nmbr ("roe_sat_agreement").

data
Roe Sat Agreement · object