POST
/
v3
/
orgs
/
{orgId}
/
iam
/
service-accounts
curl --request POST \
  --url https://api.ctrl-hub.com/v3/orgs/{orgId}/iam/service-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "data": {
    "type": "service-accounts",
    "attributes": {
      "name": "ACME Corp",
      "description": "This service account is for integrating with ACME Corp",
      "enabled": true
    }
  }
}'
{
  "data": {
    "type": "service-accounts",
    "id": "14b28316-9c20-8a7d-e85a-b62f29a29ac5",
    "attributes": {
      "name": "ACME Corp",
      "description": "This service account is for integrating with ACME Corp",
      "enabled": true,
      "email": "acmecorp@7e0c875a-fd47-401d-bd25-4278ed58d721.iam.ctrl-hub.com"
    },
    "meta": {
      "created_at": "2024-10-14T17:03:06.204Z"
    },
    "relationships": {
      "keys": {
        "data": [
          {
            "type": "service-account-keys",
            "id": "4c9d6aa9-f658-4e9e-8510-39d05a574018"
          }
        ]
      }
    }
  }
}

Authorizations

​
Authorization
string
header
required

To understand how to authenticate, see the auth docs

Body

application/json
​
data
object

Response

200
application/json
​
data
object