---
updatedAt: 2026-06-18T17:50:57.000Z
agentTools:
  siteIndex: https://developer.paylocity.com/llms.txt
  projectIndex: https://developer.paylocity.com/integrations/llms.txt
---

# Create Document Download URL

**Summary Description**

This will create a new document downloadURL for the specified company ID.


# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Document Management API",
    "description": "The Document Management API provides tools for managing documents associated with employee records and company records.  This includes the ability to list documents, filter documents by various criteria, and retrieve document download URLs.",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://dc1demogwext.paylocity.com"
    }
  ],
  "paths": {
    "/documents/v1/companies/{companyId}/documents/{documentId}/downloads": {
      "post": {
        "tags": [
          "Documents"
        ],
        "summary": "Create Document Download URL",
        "description": "**Summary Description**\n\nThis will create a new document downloadURL for the specified company ID.\n",
        "operationId": "POST_Documents_v1_companies_{companyId}_documents_{documentId}_downloads",
        "parameters": [
          {
            "name": "companyId",
            "in": "path",
            "description": "The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity.\r\n                **Allowable Values:**\r\n                9 char max",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "documentId",
            "in": "path",
            "description": "The Paylocity Document Identifier. This is the unique value provided by Paylocity to each specific Document object.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "Authorization token. Ex. Bearer ...",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DocumentDownloadModel"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/DocumentDownloadModel"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Error400Model"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Error400Model"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {}
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "500": {
            "description": "Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Error500Model"
                  }
                }
              },
              "text/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Error500Model"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "DocumentDownloadModel": {
        "type": "object",
        "properties": {
          "documentId": {
            "type": "string",
            "format": "uuid"
          },
          "downloadUrl": {
            "type": "string"
          },
          "expiresIn": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "Error400Model": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32"
          },
          "message": {
            "type": "string"
          },
          "moreInfoUrl": {
            "type": "string"
          },
          "exception": {
            "$ref": "#/components/schemas/ExceptionModel"
          },
          "fields": {
            "type": "string"
          },
          "options": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OptionModel"
            }
          }
        }
      },
      "Error500Model": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32"
          },
          "message": {
            "type": "string"
          },
          "moreInfoUrl": {
            "type": "string"
          },
          "exception": {
            "$ref": "#/components/schemas/ExceptionModel"
          },
          "errorId": {
            "type": "string"
          }
        }
      },
      "ExceptionModel": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "stackTrace": {
            "type": "string"
          },
          "innerException": {
            "$ref": "#/components/schemas/ExceptionModel"
          }
        }
      },
      "OptionModel": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "description": {
            "type": "string"
          }
        }
      },
      "ProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "status": {
            "type": "integer",
            "format": "int32"
          },
          "detail": {
            "type": "string"
          },
          "instance": {
            "type": "string"
          }
        },
        "additionalProperties": {
          "type": "object"
        }
      }
    }
  },
  "x-original-swagger-version": "2.0"
}
```