# Create

Source: <https://everruns.com/docs/api/operations/create/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Identity & access](https://everruns.com/docs/api/groups/identity-access/)/Create

# Create

Preview

Manage organizations, members, end users, invitations and connected identities.

Public APIEverruns Cloud and self-hosted Platform

POST`/v1/credential-bindings`

See [authentication](https://everruns.com/docs/sre/runbooks/authentication/) for credentials and permissions.

## Request Bodyrequired

Media typeapplication/json

Declare binding metadata. Provision its value separately through secure entry or approved capture.

object

**owner_id**

Agent or session ID, or virtual-user ID (`me` by default); omit for organization scope.

string | null

**scope**

required

Ownership and lifetime scope within the current organization.

string

Allowed values: session agent virtual_user organization

**usage**

required

Required invocation identity; agent and organization owners require service usage.

string

Allowed values: user service

**binding**

One of:

* object

  Exact HTTPS destination and injection placement; supply this or `mcp`, exclusively.

  object

  **auth**

  required

  One of:

  * object

    `Authorization: Bearer <value>`.

    object

    **type**

    required

    string

    Allowed values: bearer

  * object

    `<name>: <value>`, e.g. `X-Api-Key`.

    object

    **name**

    required

    Header name.

    string

    **type**

    required

    string

    Allowed values: header

  * object

    One application/x-www-form-urlencoded field, never a body template.

    object

    **name**

    required

    string

    **type**

    required

    string

    Allowed values: form_field

  **url**

  required

  `https://host[:port][/path-prefix]` the value may be sent to.

  string

* null

  `Authorization: Bearer <value>`.

  object

  **type**

  required

  string

  Allowed values: bearer

* object

  `<name>: <value>`, e.g. `X-Api-Key`.

  object

  **name**

  required

  Header name.

  string

  **type**

  required

  string

  Allowed values: header

* object

  One application/x-www-form-urlencoded field, never a body template.

  object

  **name**

  required

  string

  **type**

  required

  string

  Allowed values: form_field

* object

  null

**label**

required

Human-readable label, between 1 and 128 bytes.

string

**mcp**

One of:

* object

  Exact MCP endpoint, tool, and parameter; supply this or `binding`, exclusively.

  object

  **parameter_name**

  required

  Top-level parameter name; dotted nested paths are rejected.

  string

  **server_name**

  required

  Attached MCP server name used to identify the target.

  string

  **tool_name**

  required

  Exact tool name within the attached server.

  string

  **url**

  required

  Exact HTTPS MCP endpoint; arbitrary destinations cannot receive the value.

  string

* null

  null

**name**

HTTP reference name; required for HTTP bindings.

string | null

**source**

One of:

* object

  Optional native GitHub connection and bounded access request instead of a stored value.

  object

  **connection_id**

  required

  Native connection identifier; ownership and use authorization remain enforced.

  string format: uuid

  **github_access**

  required

  Explicit repository and permission bounds for each minted installation token.

  object

  **acts_as**

  required

  Whose GitHub identity answers. `none` resolves nothing.

  string

  Allowed values: none service user user_or_service

  ### Example

  ```plaintext
  service
  ```

  **permissions**

  GitHub App permission name to level (`read` or `write`).

  object

  **_key_**

  additional properties

  string

  **repositories**

  Repositories as `owner/repo`, all under one owner.

  Array\<string>

* null

  null

## Responses

201Binding declared; value is provisioned separately

### 201

Binding declared; value is provisioned separately

Media typeapplication/json

Identifier of the newly declared binding or explicit access grant.

object

**id**

required

Stable identifier used by subsequent metadata and management requests.

string format: uuid

### Example generated

```json
{
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}
```

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/credential-bindings';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"owner_id":"example","scope":"session","usage":"user","binding":{"auth":{"type":"bearer"},"url":"example"},"label":"example","mcp":{"parameter_name":"example","server_name":"example","tool_name":"example","url":"example"},"name":"example","source":{"connection_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","github_access":{"acts_as":"none","permissions":{"additionalProperty":"example"},"repositories":["example"]}}}'
};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

Request

```sh
curl --request POST \
  --url https://app.everruns.com/api/v1/credential-bindings \
  --header 'Content-Type: application/json' \
  --data '{ "owner_id": "example", "scope": "session", "usage": "user", "binding": { "auth": { "type": "bearer" }, "url": "example" }, "label": "example", "mcp": { "parameter_name": "example", "server_name": "example", "tool_name": "example", "url": "example" }, "name": "example", "source": { "connection_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "github_access": { "acts_as": "none", "permissions": { "additionalProperty": "example" }, "repositories": [ "example" ] } } }'
```

Additional language examples require JavaScript. The default request example is available above.

201

201 · Binding declared; value is provisioned separately

```json
{
  "id": "string"
}
```

## Matching endpoints