Get /files/v3/files/{file Id}/signed Url Get Signed Url

Get signed URL to access private file

GET/files/v3/files/{fileId}/signed-url

Use it in a workflow

Add a step and choose the HubSpot connector.
Pick the Get /files/v3/files/{file Id}/signed Url Get Signed Url action (under Files).
Fill in the fields below, then reference the result from later steps as {{getFilesV3FilesFileIdSignedUrlGetSignedUrl.response.data}}.

Request

Path parameters

fileIdstringrequired

ID of file.

Query parameters

expirationSecondsinteger (int64)

How long in seconds the link will provide access to the file.

sizestring

For image files. This will resize the image to the desired size before sharing. Does not affect the original file, just the file served by this signed URL.

One oficonmediumpreviewthumb

upscaleboolean

If size is provided, this will upscale the image to fit the size dimensions.

Response

Returns 200 with an object. Read it in later steps with {{getFilesV3FilesFileIdSignedUrlGetSignedUrl.response.data.<field>}}.

expiresAtstring (date-time)

Timestamp of when the URL will no longer grant access to the file.

extensionstring

Extension of the requested file.

heightinteger (int32)

For image and video files. The height of the file.

namestring

Name of the requested file.

sizeinteger (int64)

Size in bytes of the requested file.

typestring

Type of the file. Can be IMG, DOCUMENT, AUDIO, MOVIE, or OTHER.

urlstring

Signed URL with access to the specified file. Anyone with this URL will be able to access the file until it expires.

widthinteger (int32)

For image and video files. The width of the file.

json

{
  "expiresAt": "2025-01-01T00:00:00Z",
  "extension": "string",
  "name": "string",
  "size": 0,
  "type": "string",
  "url": "string",
  "height": 0,
  "width": 0
}

Need more? See the HubSpot guide for connection setup and behaviour shared by every action.

Was this page helpful?