- The filename cannot be empty
- The file extension should be
.pdf - The file size must not exceed 25 MB content length
Delegate Account
POST
/api/v1/groups/delegate/externalAccountsAllows a customer to delegate access to their company by uploading a Letter of Authorization (LOA) file.
Auth Scope
urn:grt:accountsContent-Type
multipart/form-dataRate Limit
60 req/min
Headers
| Header | Value |
|---|---|
Authorization | Bearer access-token |
Content-Type | multipart/form-data |
Request Body Parameters (form-data)
| Parameter | Type | Required | Description |
|---|---|---|---|
delegator_macnum | string | Yes | The macnum of company which delegates its rights |
file | file | No | The Letter of Authorization (LOA) file to be uploaded |
File Validation
Code Examples
Errors
| HTTP Status | Error Description | Resolution |
|---|---|---|
400 | Bad Request | Review the error response body for specific validation errors. Common issues: missing delegator_macnum, invalid file format (must be PDF), or file size exceeds 25MB. |
401 | Authentication Failed | Verify your access token is valid and included in the Authorization header with the "Bearer " prefix. |
403 | Permission Denied | Your access token does not have the required scope (urn:grt:accounts). Contact your administrator to request the appropriate permissions. |
Last updated on