GUgusto
Company Attachment

Create Company Attachment and Upload File

Upload a file and create a company attachment. We recommend uploading PDF files for optimal compatibility. However, the following file types are allowed: .qbb, .qbm, .gif, .jpg, .png, .pdf, .xls, .xlsx, .doc and .docx.

Related guides

  • Manage company attachments

scope: company_attachments:write

post/v1/companies/{company_id}/attachments

Request

Path parameters

company_idstring required

The UUID of the company

Headers

X-Gusto-API-Version'2026-06-15'

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Request body multipart/form-data

documentstring binary required

The binary payload of the file to be uploaded. Supported file types are .qbb, .qbm, .gif, .jpg, .png, .pdf, .xls, .xlsx, .doc and .docx.

category'gep_notice' | 'compliance' required

The category of a company attachment.

  • gep_notice: A tax notice attachment
  • compliance: A compliance attachment

Response

Created

uuidstring required

UUID of the company attachment

namestring required

name of the file uploaded

category'gep_notice' | 'compliance' | 'other' required

The category of the company attachment.

  • gep_notice: A tax notice attachment
  • compliance: A compliance attachment
  • other: Any other attachment type
upload_timestring required

The ISO 8601 timestamp of when an attachment was uploaded

Changes

No recorded changes to this operation across all 2 revisions of this API.