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

# Activate an Organization for the signed-in directory

> Creates an Organization for the signed-in Microsoft Entra directory, makes the signed-in account its first Owner, and starts its trial. An existing active member receives the Organization with HTTP 200. Another account in an already activated directory receives HTTP 409 and needs an invitation from an Owner.

Requires a delegated GV.Access token for a work or school account; no Organization role is required.

API · Organization

POST `/api/v1/organization:activate`

Creates an Organization for the signed-in Microsoft Entra directory, makes the signed-in account its first Owner, and starts its trial. An existing active member receives the Organization with HTTP 200. Another account in an already activated directory receives HTTP 409 and needs an invitation from an Owner. Requires a delegated GV.Access token for a work or school account; no Organization role is required.

Operation ID · activate\_organization

## Request example

```bash theme={null}
curl --request POST \
  --url 'https://api.generalvalidation.com/api/v1/organization:activate' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <access-token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example resource"
}'
```

## Authentication and access

* **Required role:** GV.Access
* **Data classification:** metadata
* **Side effects:** configurationWrite

Use an authentication scheme declared below. Ordinary workloads use application tokens; signed-in users use delegated tokens and Organization membership. Activation and invitation acceptance require a person, and execution callbacks require their registered identity.

* Microsoft Entra delegated user token

## Request body

Required

### application/json

**Schema V1OrganizationActivate**

`object`

Properties

`name`— Required

`string`

minimum length: 1 · maximum length: 255

Additional properties are not allowed.

## Responses

This guide summarizes response status codes and headers. Retrieve the deployed, authenticated OpenAPI document for the exact response body schemas and examples. The API also provides an authenticated Swagger UI; opening it in a browser does not automatically attach a bearer token.

Error responses use `application/problem+json`. The response's stable `code` and `type` map to the [error-code reference](/errors).

### 200

The directory was already activated; the caller is an active member.

#### Headers

* **ETag:** `string`
* **Location:** `string`

### 201

Organization activated with the caller as its first Owner.

#### Headers

* **ETag:** `string`
* **Location:** `string`

### 401

A valid Microsoft Entra bearer token is required.

### 403

The authenticated principal does not have the required role.

### 409

The operation conflicts with current resource or Azure state.

### 422

The request is syntactically valid but semantically invalid.

### 429

The bounded application request rate was exceeded.

#### Headers

* **Retry-After:** Seconds to wait before retrying. `integer`minimum: 1

### 503

A required dependency is temporarily unavailable.

#### Headers

* **Retry-After:** Seconds to wait before retrying. `integer`minimum: 1