# Create Buyer

Creates a new Buyer object for the client account.

## POST /public/v1/accounts/buyers

>

```json
{"openapi":"3.0.1","info":{"title":"Marketplace API","version":"5.0.5102-g2bf281b6"},"servers":[{"url":"https://api.platform.softwareone.com"}],"paths":{"/public/v1/accounts/buyers":{"post":{"tags":["Buyers"],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"buyer":{"type":"object","properties":{"ExternalIds.ErpCompanyContact":{"type":"string"},"ExternalIds.ErpCustomer":{"type":"string"},"ExternalIds.AccountExternalId":{"type":"string"},"Status":{"allOf":[{"$ref":"#/components/schemas/BuyerStatus"}]},"Address.AddressLine1":{"type":"string"},"Address.AddressLine2":{"type":"string"},"Address.PostCode":{"type":"string"},"Address.City":{"type":"string"},"Address.State":{"type":"string"},"Address.Country":{"type":"string"},"TaxId":{"type":"string"},"Account.ExternalIds.PyraTenantId":{"type":"string","format":"uuid"},"Account.ExternalId":{"type":"string"},"Account.ExternalName":{"type":"string"},"Account.Address.AddressLine1":{"type":"string"},"Account.Address.AddressLine2":{"type":"string"},"Account.Address.PostCode":{"type":"string"},"Account.Address.City":{"type":"string"},"Account.Address.State":{"type":"string"},"Account.Address.Country":{"type":"string"},"Account.TechnicalSupportEmail":{"type":"string"},"Account.Website":{"type":"string"},"Account.Description":{"type":"string"},"Account.Groups":{"type":"array","items":{"$ref":"#/components/schemas/UserGroupQueryModel"}},"Account.Eligibility.Client":{"type":"boolean"},"Account.Eligibility.Partner":{"type":"boolean"},"Account.DefaultLanguageCode":{"type":"string"},"Account.Type":{"allOf":[{"$ref":"#/components/schemas/AccountType"}]},"Account.Status":{"allOf":[{"$ref":"#/components/schemas/AccountStatus"}]},"Account.Metadata.OmittedProperties":{"type":"array","items":{"type":"string"}},"Account.Name":{"type":"string"},"Account.Icon":{"type":"string"},"Account.Revision":{"type":"integer","format":"int32"},"Account.Audit.Created.At":{"type":"string","format":"date-time"},"Account.Audit.Created.ById":{"type":"string"},"Account.Audit.Created.By.Type":{"allOf":[{"$ref":"#/components/schemas/IdentityType"}]},"Account.Audit.Created.By.Metadata.OmittedProperties":{"type":"array","items":{"type":"string"}},"Account.Audit.Created.By.Name":{"type":"string"},"Account.Audit.Created.By.Icon":{"type":"string"},"Account.Audit.Created.By.Revision":{"type":"integer","format":"int32"},"Account.Audit.Created.By.Audit.Created":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectEvent"}]},"Account.Audit.Created.By.Audit.Updated.At":{"type":"string","format":"date-time"},"Account.Audit.Created.By.Audit.Updated.ById":{"type":"string"},"Account.Audit.Created.By.Audit.Updated.By":{"allOf":[{"$ref":"#/components/schemas/PlatformIdentity"}]},"Account.Audit.Created.By.Id":{"type":"string"},"Account.Audit.Updated.At":{"type":"string","format":"date-time"},"Account.Audit.Updated.ById":{"type":"string"},"Account.Audit.Updated.By.Type":{"allOf":[{"$ref":"#/components/schemas/IdentityType"}]},"Account.Audit.Updated.By.Metadata.OmittedProperties":{"type":"array","items":{"type":"string"}},"Account.Audit.Updated.By.Name":{"type":"string"},"Account.Audit.Updated.By.Icon":{"type":"string"},"Account.Audit.Updated.By.Revision":{"type":"integer","format":"int32"},"Account.Audit.Updated.By.Audit.Created.At":{"type":"string","format":"date-time"},"Account.Audit.Updated.By.Audit.Created.ById":{"type":"string"},"Account.Audit.Updated.By.Audit.Created.By":{"allOf":[{"$ref":"#/components/schemas/PlatformIdentity"}]},"Account.Audit.Updated.By.Audit.Updated":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectEvent"}]},"Account.Audit.Updated.By.Id":{"type":"string"},"Account.Id":{"type":"string"},"Errors":{"type":"array","items":{"$ref":"#/components/schemas/ParametrisedMessage"}},"Sellers":{"type":"array","items":{"$ref":"#/components/schemas/Seller"}},"ErpLinks":{"type":"array","items":{"$ref":"#/components/schemas/ErpLink"}},"Metadata.OmittedProperties":{"type":"array","items":{"type":"string"}},"Name":{"type":"string"},"Icon":{"type":"string"},"Revision":{"type":"integer","format":"int32"},"Audit.Activated.At":{"type":"string","format":"date-time"},"Audit.Activated.ById":{"type":"string"},"Audit.Activated.By.Type":{"allOf":[{"$ref":"#/components/schemas/IdentityType"}]},"Audit.Activated.By.Metadata.OmittedProperties":{"type":"array","items":{"type":"string"}},"Audit.Activated.By.Name":{"type":"string"},"Audit.Activated.By.Icon":{"type":"string"},"Audit.Activated.By.Revision":{"type":"integer","format":"int32"},"Audit.Activated.By.Audit.Created.At":{"type":"string","format":"date-time"},"Audit.Activated.By.Audit.Created.ById":{"type":"string"},"Audit.Activated.By.Audit.Created.By":{"allOf":[{"$ref":"#/components/schemas/PlatformIdentity"}]},"Audit.Activated.By.Audit.Updated.At":{"type":"string","format":"date-time"},"Audit.Activated.By.Audit.Updated.ById":{"type":"string"},"Audit.Activated.By.Audit.Updated.By":{"allOf":[{"$ref":"#/components/schemas/PlatformIdentity"}]},"Audit.Activated.By.Id":{"type":"string"},"Audit.Unassigned.At":{"type":"string","format":"date-time"},"Audit.Unassigned.ById":{"type":"string"},"Audit.Unassigned.By.Type":{"allOf":[{"$ref":"#/components/schemas/IdentityType"}]},"Audit.Unassigned.By.Metadata.OmittedProperties":{"type":"array","items":{"type":"string"}},"Audit.Unassigned.By.Name":{"type":"string"},"Audit.Unassigned.By.Icon":{"type":"string"},"Audit.Unassigned.By.Revision":{"type":"integer","format":"int32"},"Audit.Unassigned.By.Audit.Created.At":{"type":"string","format":"date-time"},"Audit.Unassigned.By.Audit.Created.ById":{"type":"string"},"Audit.Unassigned.By.Audit.Created.By":{"allOf":[{"$ref":"#/components/schemas/PlatformIdentity"}]},"Audit.Unassigned.By.Audit.Updated.At":{"type":"string","format":"date-time"},"Audit.Unassigned.By.Audit.Updated.ById":{"type":"string"},"Audit.Unassigned.By.Audit.Updated.By":{"allOf":[{"$ref":"#/components/schemas/PlatformIdentity"}]},"Audit.Unassigned.By.Id":{"type":"string"},"Audit.Disabled.At":{"type":"string","format":"date-time"},"Audit.Disabled.ById":{"type":"string"},"Audit.Disabled.By.Type":{"allOf":[{"$ref":"#/components/schemas/IdentityType"}]},"Audit.Disabled.By.Metadata.OmittedProperties":{"type":"array","items":{"type":"string"}},"Audit.Disabled.By.Name":{"type":"string"},"Audit.Disabled.By.Icon":{"type":"string"},"Audit.Disabled.By.Revision":{"type":"integer","format":"int32"},"Audit.Disabled.By.Audit.Created.At":{"type":"string","format":"date-time"},"Audit.Disabled.By.Audit.Created.ById":{"type":"string"},"Audit.Disabled.By.Audit.Created.By":{"allOf":[{"$ref":"#/components/schemas/PlatformIdentity"}]},"Audit.Disabled.By.Audit.Updated.At":{"type":"string","format":"date-time"},"Audit.Disabled.By.Audit.Updated.ById":{"type":"string"},"Audit.Disabled.By.Audit.Updated.By":{"allOf":[{"$ref":"#/components/schemas/PlatformIdentity"}]},"Audit.Disabled.By.Id":{"type":"string"},"Audit.Created.At":{"type":"string","format":"date-time"},"Audit.Created.ById":{"type":"string"},"Audit.Created.By.Type":{"allOf":[{"$ref":"#/components/schemas/IdentityType"}]},"Audit.Created.By.Metadata.OmittedProperties":{"type":"array","items":{"type":"string"}},"Audit.Created.By.Name":{"type":"string"},"Audit.Created.By.Icon":{"type":"string"},"Audit.Created.By.Revision":{"type":"integer","format":"int32"},"Audit.Created.By.Audit.Created.At":{"type":"string","format":"date-time"},"Audit.Created.By.Audit.Created.ById":{"type":"string"},"Audit.Created.By.Audit.Created.By":{"allOf":[{"$ref":"#/components/schemas/PlatformIdentity"}]},"Audit.Created.By.Audit.Updated.At":{"type":"string","format":"date-time"},"Audit.Created.By.Audit.Updated.ById":{"type":"string"},"Audit.Created.By.Audit.Updated.By":{"allOf":[{"$ref":"#/components/schemas/PlatformIdentity"}]},"Audit.Created.By.Id":{"type":"string"},"Audit.Updated.At":{"type":"string","format":"date-time"},"Audit.Updated.ById":{"type":"string"},"Audit.Updated.By.Type":{"allOf":[{"$ref":"#/components/schemas/IdentityType"}]},"Audit.Updated.By.Metadata.OmittedProperties":{"type":"array","items":{"type":"string"}},"Audit.Updated.By.Name":{"type":"string"},"Audit.Updated.By.Icon":{"type":"string"},"Audit.Updated.By.Revision":{"type":"integer","format":"int32"},"Audit.Updated.By.Audit.Created.At":{"type":"string","format":"date-time"},"Audit.Updated.By.Audit.Created.ById":{"type":"string"},"Audit.Updated.By.Audit.Created.By":{"allOf":[{"$ref":"#/components/schemas/PlatformIdentity"}]},"Audit.Updated.By.Audit.Updated.At":{"type":"string","format":"date-time"},"Audit.Updated.By.Audit.Updated.ById":{"type":"string"},"Audit.Updated.By.Audit.Updated.By":{"allOf":[{"$ref":"#/components/schemas/PlatformIdentity"}]},"Audit.Updated.By.Id":{"type":"string"},"Id":{"type":"string"}},"description":"Json representation of the buyer"},"logo":{"type":"string","format":"binary"}}},"encoding":{"buyer":{"contentType":"application/json"},"logo":{"contentType":"application/octet-stream"}}},"application/json":{"schema":{"$ref":"#/components/schemas/BuyerCreate"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Buyer"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}}},"components":{"schemas":{"BuyerStatus":{"enum":["Active","Enabled","Disabled","Deleted","Unassigned","Conflict","Mismatch"],"type":"string"},"UserGroupQueryModel":{"type":"object","properties":{"id":{"type":"string"},"audit":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectAudit"}]},"$meta":{"allOf":[{"$ref":"#/components/schemas/PlatformMetadata"}],"nullable":true},"name":{"type":"string"},"revision":{"type":"integer","format":"int32"},"description":{"type":"string","nullable":true},"account":{"type":"object","allOf":[{"$ref":"#/components/schemas/AccountRef"}]},"modules":{"type":"array","items":{"$ref":"#/components/schemas/ModuleRef"}},"logo":{"type":"string","nullable":true},"isDefault":{"type":"boolean"},"users":{"type":"array","items":{"$ref":"#/components/schemas/UserRef"}},"extensions":{"type":"array","items":{"$ref":"#/components/schemas/PlatformObjectAuditPlatformExtension"},"nullable":true},"buyers":{"type":"array","items":{"$ref":"#/components/schemas/BuyerRef"},"nullable":true}},"additionalProperties":false},"PlatformObjectAudit":{"type":"object","properties":{"created":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectEvent"}],"nullable":true},"updated":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectEvent"}],"nullable":true}},"additionalProperties":false},"PlatformObjectEvent":{"type":"object","properties":{"at":{"type":"string","format":"date-time","nullable":true},"by":{"type":"object","allOf":[{"$ref":"#/components/schemas/PlatformIdentityRef"}]}},"additionalProperties":false},"PlatformIdentityRef":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"icon":{"type":"string","nullable":true},"revision":{"type":"integer","format":"int32"}},"additionalProperties":false},"PlatformMetadata":{"type":"object","properties":{"omitted":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"AccountRef":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"icon":{"type":"string","nullable":true},"revision":{"type":"integer","format":"int32"},"type":{"allOf":[{"$ref":"#/components/schemas/AccountType"}],"nullable":true},"status":{"allOf":[{"$ref":"#/components/schemas/AccountStatus"}],"nullable":true}},"additionalProperties":false},"AccountType":{"enum":["Client","Vendor","Operations"],"type":"string"},"AccountStatus":{"enum":["Active","Enabled","Disabled"],"type":"string"},"ModuleRef":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"revision":{"type":"integer","format":"int32"},"description":{"type":"string"},"filters":{"allOf":[{"$ref":"#/components/schemas/Filters"}],"nullable":true},"settings":{"allOf":[{"$ref":"#/components/schemas/ModuleSettings"}],"nullable":true}},"additionalProperties":false},"Filters":{"type":"object","properties":{"group.buyers":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"ModuleSettings":{"type":"object","properties":{"sharedAccount":{"type":"boolean","deprecated":true},"configurable":{"type":"boolean"},"default":{"type":"boolean"},"paid":{"type":"boolean"},"type":{"type":"array","items":{"type":"string"}},"obsolete":{"type":"boolean"},"eligibility":{"allOf":[{"$ref":"#/components/schemas/ModuleSettingsEligibility"}],"nullable":true}},"additionalProperties":false},"ModuleSettingsEligibility":{"type":"object","properties":{"multi":{"type":"boolean"},"single":{"type":"boolean"}},"additionalProperties":false},"UserRef":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"icon":{"type":"string","nullable":true},"revision":{"type":"integer","format":"int32"}},"additionalProperties":false},"PlatformObjectAuditPlatformExtension":{"type":"object","properties":{"id":{"type":"string"},"audit":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectAudit"}],"nullable":true},"$meta":{"allOf":[{"$ref":"#/components/schemas/PlatformMetadata"}],"nullable":true},"name":{"type":"string"},"icon":{"type":"string","nullable":true},"revision":{"type":"integer","format":"int32"},"status":{"enum":["Draft","Private","Public","Deleted"],"type":"string"}},"additionalProperties":false},"BuyerRef":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"icon":{"type":"string","nullable":true},"revision":{"type":"integer","format":"int32"}},"additionalProperties":false},"IdentityType":{"enum":["User","ApiToken","Service","Extension"],"type":"string"},"PlatformIdentity":{"type":"object","properties":{"id":{"type":"string"},"audit":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectAudit"}]},"$meta":{"allOf":[{"$ref":"#/components/schemas/PlatformMetadata"}],"nullable":true},"name":{"type":"string"},"icon":{"type":"string","nullable":true},"revision":{"type":"integer","format":"int32"}},"additionalProperties":false},"ParametrisedMessage":{"type":"object","properties":{"id":{"type":"string","nullable":true},"message":{"type":"string","nullable":true},"parameters":{"nullable":true}},"additionalProperties":false},"Seller":{"type":"object","properties":{"id":{"type":"string"},"audit":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectAudit"}]},"$meta":{"allOf":[{"$ref":"#/components/schemas/PlatformMetadata"}],"nullable":true},"name":{"type":"string"},"icon":{"type":"string","nullable":true},"revision":{"type":"integer","format":"int32"},"externalId":{"type":"string","nullable":true},"status":{"allOf":[{"$ref":"#/components/schemas/SellerStatus"}],"nullable":true},"currencies":{"type":"array","items":{"$ref":"#/components/schemas/SellerCurrency"},"nullable":true},"address":{"allOf":[{"$ref":"#/components/schemas/Address"}]},"erpLink":{"type":"object","allOf":[{"$ref":"#/components/schemas/ErpLinkRef"}]}},"additionalProperties":false},"SellerStatus":{"enum":["Active","Disabled","Offline","Deleted"],"type":"string"},"SellerCurrency":{"type":"object","properties":{"value":{"type":"string"},"billingEnabled":{"type":"boolean"},"isDefault":{"type":"boolean"}},"additionalProperties":false},"Address":{"type":"object","properties":{"addressLine1":{"type":"string","nullable":true},"addressLine2":{"type":"string","nullable":true},"postCode":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"country":{"type":"string","nullable":true}},"additionalProperties":false},"ErpLinkRef":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"icon":{"type":"string","nullable":true},"revision":{"type":"integer","format":"int32"},"companyName":{"type":"string","nullable":true},"status":{"allOf":[{"$ref":"#/components/schemas/ErpLinkStatus"}]}},"additionalProperties":false},"ErpLinkStatus":{"enum":["Active","Blocked"],"type":"string"},"ErpLink":{"type":"object","properties":{"id":{"type":"string"},"audit":{"allOf":[{"$ref":"#/components/schemas/ErpLinkAudit"}]},"$meta":{"allOf":[{"$ref":"#/components/schemas/PlatformMetadata"}],"nullable":true},"name":{"type":"string"},"icon":{"type":"string","nullable":true},"revision":{"type":"integer","format":"int32"},"buyer":{"type":"object","allOf":[{"$ref":"#/components/schemas/BuyerRef"}]},"seller":{"type":"object","allOf":[{"$ref":"#/components/schemas/SellerRef"}]},"companyName":{"type":"string","nullable":true},"status":{"allOf":[{"$ref":"#/components/schemas/ErpLinkStatus"}]},"note":{"type":"string","nullable":true},"externalIds":{"allOf":[{"$ref":"#/components/schemas/BuyerExternalIds"}],"nullable":true},"address":{"allOf":[{"$ref":"#/components/schemas/Address"}],"nullable":true}},"additionalProperties":false},"ErpLinkAudit":{"type":"object","properties":{"created":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectEvent"}],"nullable":true},"updated":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectEvent"}],"nullable":true},"blocked":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectEvent"}],"nullable":true},"unblocked":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectEvent"}],"nullable":true}},"additionalProperties":false},"SellerRef":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"icon":{"type":"string","nullable":true},"revision":{"type":"integer","format":"int32"},"externalId":{"type":"string","nullable":true}},"additionalProperties":false},"BuyerExternalIds":{"type":"object","properties":{"erpCompanyContact":{"type":"string","nullable":true},"erpCustomer":{"type":"string","nullable":true},"accountExternalId":{"type":"string","nullable":true}},"additionalProperties":false},"BuyerCreate":{"required":["address","name"],"type":"object","properties":{"id":{"type":"string"},"audit":{"allOf":[{"$ref":"#/components/schemas/BuyerAudit"}]},"$meta":{"allOf":[{"$ref":"#/components/schemas/PlatformMetadata"}],"nullable":true},"name":{"maxLength":500,"minLength":1,"type":"string"},"icon":{"type":"string","nullable":true},"revision":{"type":"integer","format":"int32"},"externalIds":{"allOf":[{"$ref":"#/components/schemas/BuyerExternalIds"}],"nullable":true},"status":{"allOf":[{"$ref":"#/components/schemas/BuyerStatus"}],"nullable":true},"address":{"allOf":[{"$ref":"#/components/schemas/Address"}]},"taxId":{"maxLength":18,"type":"string","nullable":true},"account":{"type":"object","allOf":[{"$ref":"#/components/schemas/AccountRef"}]},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ParametrisedMessage"},"nullable":true},"sellers":{"type":"array","items":{"$ref":"#/components/schemas/SellerRef"},"nullable":true}},"additionalProperties":false},"BuyerAudit":{"type":"object","properties":{"created":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectEvent"}],"nullable":true},"updated":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectEvent"}],"nullable":true},"activated":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectEvent"}],"nullable":true},"unassigned":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectEvent"}],"nullable":true},"disabled":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectEvent"}],"nullable":true}},"additionalProperties":false},"Buyer":{"type":"object","properties":{"id":{"type":"string"},"audit":{"allOf":[{"$ref":"#/components/schemas/BuyerAudit"}]},"$meta":{"allOf":[{"$ref":"#/components/schemas/PlatformMetadata"}],"nullable":true},"name":{"type":"string"},"icon":{"type":"string","nullable":true},"revision":{"type":"integer","format":"int32"},"externalIds":{"allOf":[{"$ref":"#/components/schemas/BuyerExternalIds"}],"nullable":true},"status":{"allOf":[{"$ref":"#/components/schemas/BuyerStatus"}],"nullable":true},"address":{"allOf":[{"$ref":"#/components/schemas/Address"}],"nullable":true},"taxId":{"type":"string","nullable":true},"account":{"type":"object","allOf":[{"$ref":"#/components/schemas/AccountRef"}]},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ParametrisedMessage"},"nullable":true},"sellers":{"type":"array","items":{"$ref":"#/components/schemas/SellerRef"},"nullable":true}},"additionalProperties":false},"ProblemDetails":{"type":"object","properties":{"type":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"status":{"type":"integer","format":"int32","nullable":true},"detail":{"type":"string","nullable":true},"instance":{"type":"string","nullable":true}},"additionalProperties":{}}}}}
```