> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Access Request

Create an access request for one or more identities.

**Required User Roles:**

* `ORG_ADMIN`
* `USER`

**Required permissions:**

* `idn:access-request:manage`
* `idn:access-request-self:manage`

For more information about the user roles refer to the [User Level Permissions](https://documentation.sailpoint.com/saas/help/common/users/user_levels.html).

<Note>
  External Documentation

  To learn more, visit the [SailPoint documentation](https://developer.sailpoint.com/docs/api/v3/create-access-request).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter           | Description                                                                                                                                                                                                                                                                                                                                                                                                                 |
  | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Comment             | The comment for the requested item.<br /><br />**Note:** Comment is required when the request is of type `Revoke Access`.                                                                                                                                                                                                                                                                                                   |
  | Remove Date         | Select an expiration date and time when access will be automatically removed.<br /><br />**Note**:<br />\* The system may take up to 24 hours to complete the removal after the date is reached.<br />\* You can extend access or remove an existing expiration date using a `GRANT_ACCESS` request type.<br />\* You can shorten access or add an expiration date using either `GRANT_ACCESS` or `REVOKE_ACCESS` requests. |
  | Request Type        | Select the access request type.                                                                                                                                                                                                                                                                                                                                                                                             |
  | Requested For       | A comma-separated list of identity IDs to request access for.<br /><br />**Note:** if the request type is `REVOKE_ACCESS`, only one identity ID is allowed.                                                                                                                                                                                                                                                                 |
  | Requested Item ID   | The ID of the `Role`, `Access Profile` or `Entitlement` included in the request.                                                                                                                                                                                                                                                                                                                                            |
  | Requested Item Type | Select the type of the item being requested.                                                                                                                                                                                                                                                                                                                                                                                |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter       | Description                                                                                                                                                                                                                                                                                                                         |
  | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Client Metadata | The key-value metadata to attach to the access request.<br /><br />A free-form field for adding custom information to the request, which the system stores for you but does not process.<br /><br />For example: <br /><pre><code>\{<br />  "requestedAppId":"2c91808f78",<br />  "requestedAppName":"test-app"<br />}</code></pre> |
</div>

## Example Output

```json theme={"dark"}
{
	"newRequests": [
		{
			"requestedFor": "899fd612ecfc4cf3bf48f14d0afdef89",
			"requestedItemsDetails": [
				{
					"type": "ENTITLEMENT",
					"id": "779c6fd7171540bba1184e5946112c28"
				}
			],
			"attributesHash": -1928438224,
			"accessRequestIds": [
				"5d3118c518a44ec7805450d53479ccdb"
			]
		}
	],
	"existingRequests": [
		{
			"requestedFor": "899fd612ecfc4cf3bf48f14d0afdef89",
			"requestedItemsDetails": [
				{
					"type": "ROLE",
					"id": "779c6fd7171540bbc1184e5946112c28"
				}
			],
			"attributesHash": 2843118224,
			"accessRequestIds": [
				"5d3118c518a44ec7805450d53479ccdc"
			]
		}
	]
}
```

## Workflow Library Example

[Create Access Request with Sailpoint and Send Results Via Email](https://library.blinkops.com/workflows/create-access-request-with-sailpoint-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/create-access-request-with-sailpoint-and-send-results-via-email/canvas" />
</div>