Create account

Create account

post

Create a new account. Available for Operations account with platform account management permissions. Creates account record and optional user groups/modules scope. When used Content-type: application/json - account created without icon. When used Content-type: multipart/form-data - account created with icon, parts should account and logo. Returns the created account object.

Body

multipart/form-dataapplication/json

logostring · binaryOptional

Responses

201

Created

application/json

idstringOptional

namestringOptional

iconstring · nullableOptional

revisioninteger · int32Optional

typestring · enumOptionalPossible values:

statusstring · enumOptionalPossible values:

externalIdstring · nullableOptional

externalNamestring · nullableOptional

technicalSupportEmailstring · nullableOptional

websitestring · nullableOptional

descriptionstring · nullableOptional

defaultLanguageCodestring · nullableOptional

400

Bad Request

application/json

post/public/v1/accounts/accounts

HTTPcURLJavaScriptPython

POST /public/v1/accounts/accounts HTTP/1.1
Host: api.platform.softwareone.com
Content-Type: multipart/form-data
Accept: */*
Content-Length: 3437

{
  "account": {
    "ExternalIds.PyraTenantId": "123e4567-e89b-12d3-a456-426614174000",
    "ExternalId": "text",
    "ExternalName": "text",
    "Address.AddressLine1": "text",
    "Address.AddressLine2": "text",
    "Address.PostCode": "text",
    "Address.City": "text",
    "Address.State": "text",
    "Address.Country": "text",
    "TechnicalSupportEmail": "text",
    "Website": "text",
    "Description": "text",
    "Groups": [
      {
        "id": "text",
        "audit": {
          "created": {
            "at": "2026-07-15T19:33:57.363Z",
            "by": {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1
            }
          },
          "updated": {
            "at": "2026-07-15T19:33:57.363Z",
            "by": {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1
            }
          }
        },
        "$meta": {
          "omitted": [
            "text"
          ]
        },
        "name": "text",
        "revision": 1,
        "description": "text",
        "account": {
          "id": "text",
          "name": "text",
          "icon": "text",
          "revision": 1,
          "type": "Client",
          "status": "Active"
        },
        "modules": [
          {
            "id": "text",
            "name": "text",
            "revision": 1,
            "description": "text",
            "filters": {
              "group.buyers": [
                "text"
              ]
            },
            "settings": {
              "configurable": true,
              "default": true,
              "paid": true,
              "type": [
                "text"
              ],
              "obsolete": true,
              "eligibility": {
                "multi": true,
                "single": true
              }
            }
          }
        ],
        "logo": "text",
        "isDefault": true,
        "users": [
          {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        ],
        "extensions": [
          {
            "id": "text",
            "audit": {
              "created": {
                "at": "2026-07-15T19:33:57.363Z",
                "by": {
                  "id": "text",
                  "name": "text",
                  "icon": "text",
                  "revision": 1
                }
              },
              "updated": {
                "at": "2026-07-15T19:33:57.363Z",
                "by": {
                  "id": "text",
                  "name": "text",
                  "icon": "text",
                  "revision": 1
                }
              }
            },
            "$meta": {
              "omitted": [
                "text"
              ]
            },
            "name": "text",
            "icon": "text",
            "revision": 1,
            "status": "Draft"
          }
        ],
        "buyers": [
          {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        ]
      }
    ],
    "Eligibility.Client": true,
    "Eligibility.Partner": true,
    "DefaultLanguageCode": "text",
    "Type": "Client",
    "Status": "Active",
    "Metadata.OmittedProperties": [
      "text"
    ],
    "Name": "text",
    "Icon": "text",
    "Revision": 1,
    "Audit.Created.At": "2026-07-15T19:33:57.363Z",
    "Audit.Created.ById": "text",
    "Audit.Created.By.Type": "User",
    "Audit.Created.By.Metadata.OmittedProperties": [
      "text"
    ],
    "Audit.Created.By.Name": "text",
    "Audit.Created.By.Icon": "text",
    "Audit.Created.By.Revision": 1,
    "Audit.Created.By.Audit.Created": {
      "at": "2026-07-15T19:33:57.363Z",
      "by": {
        "id": "text",
        "name": "text",
        "icon": "text",
        "revision": 1
      }
    },
    "Audit.Created.By.Audit.Updated.At": "2026-07-15T19:33:57.363Z",
    "Audit.Created.By.Audit.Updated.ById": "text",
    "Audit.Created.By.Audit.Updated.By": {
      "id": "text",
      "audit": {
        "created": {
          "at": "2026-07-15T19:33:57.363Z",
          "by": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        },
        "updated": {
          "at": "2026-07-15T19:33:57.363Z",
          "by": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        }
      },
      "$meta": {
        "omitted": [
          "text"
        ]
      },
      "name": "text",
      "icon": "text",
      "revision": 1
    },
    "Audit.Created.By.Id": "text",
    "Audit.Updated.At": "2026-07-15T19:33:57.363Z",
    "Audit.Updated.ById": "text",
    "Audit.Updated.By.Type": "User",
    "Audit.Updated.By.Metadata.OmittedProperties": [
      "text"
    ],
    "Audit.Updated.By.Name": "text",
    "Audit.Updated.By.Icon": "text",
    "Audit.Updated.By.Revision": 1,
    "Audit.Updated.By.Audit.Created.At": "2026-07-15T19:33:57.363Z",
    "Audit.Updated.By.Audit.Created.ById": "text",
    "Audit.Updated.By.Audit.Created.By": {
      "id": "text",
      "audit": {
        "created": {
          "at": "2026-07-15T19:33:57.363Z",
          "by": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        },
        "updated": {
          "at": "2026-07-15T19:33:57.363Z",
          "by": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        }
      },
      "$meta": {
        "omitted": [
          "text"
        ]
      },
      "name": "text",
      "icon": "text",
      "revision": 1
    },
    "Audit.Updated.By.Audit.Updated": {
      "at": "2026-07-15T19:33:57.363Z",
      "by": {
        "id": "text",
        "name": "text",
        "icon": "text",
        "revision": 1
      }
    },
    "Audit.Updated.By.Id": "text",
    "Id": "text"
  },
  "logo": "binary"
}

multipart/form-dataapplication/json

{
  "id": "ACC-1234-1234",
  "revision": 1,
  "name": "Contoso Ltd",
  "type": "Vendor",
  "status": "Active",
  "externalId": "WW-CON-123456",
  "externalName": "Contoso",
  "website": "https://contoso.com",
  "description": "Enterprise customer account",
  "address": {
    "addressLine1": "123 Main Street",
    "addressLine2": "Apt 4B",
    "postCode": "12345",
    "city": "Cityville",
    "state": "S",
    "country": "ST"
  },
  "eligibility": {
    "client": true,
    "partner": false
  },
  "audit": {
    "created": {
      "at": "2024-02-01T09:12:23+00:00",
      "by": {
        "id": "USR-0001",
        "name": "Ops User"
      }
    },
    "updated": {
      "at": "2024-02-01T09:12:23+00:00",
      "by": {
        "id": "USR-0001",
        "name": "Ops User"
      }
    }
  }
}