---
title: "Create Provision Result"
method: POST
path: "/provision-requests/{provisionRequestId}/results"
tags: ["Provision Results"]
---

# Create Provision Result

`POST /provision-requests/{provisionRequestId}/results`

## Request

- Base URL: `https://api.pax8.com/v2`
- URL: `https://api.pax8.com/v2/provision-requests/{provisionRequestId}/results`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.pax8.com/v1/token`

## Path parameters

- `provisionRequestId` string, uuid, required

## Request body

- ProvisionResult
  - `id` string, uuid
  - `provisionAttemptId` string, uuid
  - `status` 'Success' | 'Fail', required: The status of the provision result. Must be either `Success` or `Fail`. If `Fail` an `errorMessage` should be present.
  - `errorMessage` string: When the status is Fail, the `errorMessage` field should contain relevant error information that a person can understand and action. The `errorMessage` input is truncated to 500 characters.
  - `metadata` object
  - `externalProvisionerSubscriptionId` string: Cannot be empty and must only contain alphanumeric values, hyphens and underscores.
  - `externalProvisionerPartnerId` string: Cannot be empty and must only contain alphanumeric values, hyphens and underscores.
  - `externalProvisionerCompanyId` string: Cannot be empty and must only contain alphanumeric values, hyphens and underscores.
  - `externalProvisionerPartnerEnrollmentId` string: Cannot be empty and must only contain alphanumeric values, hyphens and underscores.

## Response `200`

OK

- ProvisionResult
  - `id` string, uuid
  - `provisionAttemptId` string, uuid
  - `status` 'Success' | 'Fail', required: The status of the provision result. Must be either `Success` or `Fail`. If `Fail` an `errorMessage` should be present.
  - `errorMessage` string: When the status is Fail, the `errorMessage` field should contain relevant error information that a person can understand and action. The `errorMessage` input is truncated to 500 characters.
  - `metadata` object
  - `externalProvisionerSubscriptionId` string: Cannot be empty and must only contain alphanumeric values, hyphens and underscores.
  - `externalProvisionerPartnerId` string: Cannot be empty and must only contain alphanumeric values, hyphens and underscores.
  - `externalProvisionerCompanyId` string: Cannot be empty and must only contain alphanumeric values, hyphens and underscores.
  - `externalProvisionerPartnerEnrollmentId` string: Cannot be empty and must only contain alphanumeric values, hyphens and underscores.

---

[API](https://skmtc.dev/pax8/apis/vendor-provisioning-endpoints.md) - [All operations](https://skmtc.dev/pax8/apis/vendor-provisioning-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/pax8/apis/vendor-provisioning-endpoints/revisions/33a972829ae0?raw)