Create Buyer
Creates a new Buyer object for the client account.
post
Body
logostring · binaryOptional
Responses
201
Created
application/json
400
Bad Request
application/json
post
/public/v1/accounts/buyersLast updated
Was this helpful?
Creates a new Buyer object for the client account.
Created
Bad Request
Last updated
Was this helpful?
Was this helpful?
POST /public/v1/accounts/buyers HTTP/1.1
Host: api.platform.softwareone.com
Content-Type: multipart/form-data
Accept: */*
Content-Length: 15586
{
"buyer": {
"ExternalIds.ErpCompanyContact": "text",
"ExternalIds.ErpCustomer": "text",
"ExternalIds.AccountExternalId": "text",
"Status": "Active",
"Address.AddressLine1": "text",
"Address.AddressLine2": "text",
"Address.PostCode": "text",
"Address.City": "text",
"Address.State": "text",
"Address.Country": "text",
"TaxId": "text",
"Account.ExternalIds.PyraTenantId": "123e4567-e89b-12d3-a456-426614174000",
"Account.ExternalId": "text",
"Account.ExternalName": "text",
"Account.Type": "Client",
"Account.Status": "Active",
"Account.ServiceLevel": "Express",
"Account.Address.AddressLine1": "text",
"Account.Address.AddressLine2": "text",
"Account.Address.PostCode": "text",
"Account.Address.City": "text",
"Account.Address.State": "text",
"Account.Address.Country": "text",
"Account.TechnicalSupportEmail": "text",
"Account.Website": "text",
"Account.Description": "text",
"Account.Name": "text",
"Account.Groups": [
{
"id": "text",
"audit": {
"created": "[Circular Reference]",
"updated": "[Circular Reference]"
},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"description": "text",
"account": {
"id": "text",
"icon": "text",
"type": "text",
"status": "text",
"name": "text"
},
"modules": [
{
"id": "text",
"description": "text",
"name": "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",
"icon": "text",
"name": "text"
}
],
"buyers": [
{
"id": "text",
"icon": "text",
"name": "text"
}
]
}
],
"Account.Eligibility.Client": true,
"Account.Eligibility.Partner": true,
"Account.Icon": "text",
"Account.Metadata.OmittedProperties": [
"text"
],
"Account.Audit.Created.At": "2026-01-06T20:26:18.045Z",
"Account.Audit.Created.ById": "text",
"Account.Audit.Created.By.Name": "text",
"Account.Audit.Created.By.Icon": "text",
"Account.Audit.Created.By.HasIcon": true,
"Account.Audit.Created.By.Type": "User",
"Account.Audit.Created.By.Metadata.OmittedProperties": [
"text"
],
"Account.Audit.Created.By.Audit.Created": {
"at": "2026-01-06T20:26:18.045Z",
"by": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
}
},
"Account.Audit.Created.By.Audit.Updated.At": "2026-01-06T20:26:18.045Z",
"Account.Audit.Created.By.Audit.Updated.ById": "text",
"Account.Audit.Created.By.Audit.Updated.By": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
},
"Account.Audit.Created.By.Id": "text",
"Account.Audit.Created.By.SystemId": 1,
"Account.Audit.Updated.At": "2026-01-06T20:26:18.045Z",
"Account.Audit.Updated.ById": "text",
"Account.Audit.Updated.By.Name": "text",
"Account.Audit.Updated.By.Icon": "text",
"Account.Audit.Updated.By.HasIcon": true,
"Account.Audit.Updated.By.Type": "User",
"Account.Audit.Updated.By.Metadata.OmittedProperties": [
"text"
],
"Account.Audit.Updated.By.Audit.Created.At": "2026-01-06T20:26:18.045Z",
"Account.Audit.Updated.By.Audit.Created.ById": "text",
"Account.Audit.Updated.By.Audit.Created.By": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
},
"Account.Audit.Updated.By.Audit.Updated": {
"at": "2026-01-06T20:26:18.045Z",
"by": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
}
},
"Account.Audit.Updated.By.Id": "text",
"Account.Audit.Updated.By.SystemId": 1,
"Account.Id": "text",
"Account.SystemId": 1,
"Name": "text",
"Errors": [
{
"id": "text",
"message": "text",
"parameters": null
}
],
"Sellers": [
{
"id": "text",
"audit": {
"created": "[Circular Reference]",
"updated": "[Circular Reference]"
},
"$meta": {
"omitted": [
"text"
]
},
"icon": "text",
"externalId": "text",
"status": "text",
"currencies": [
"text"
],
"address": {
"addressLine1": "text",
"addressLine2": "text",
"postCode": "text",
"city": "text",
"state": "text",
"country": "text"
},
"name": "text",
"erpLink": {
"id": "text",
"icon": "text",
"name": "text",
"companyName": "text",
"status": "text"
}
}
],
"ErpLinks": [
{
"id": "text",
"audit": {
"created": "[Circular Reference]",
"updated": "[Circular Reference]",
"blocked": "[Circular Reference]",
"unblocked": "[Circular Reference]"
},
"$meta": {
"omitted": [
"text"
]
},
"icon": "text",
"buyer": {
"id": "text",
"icon": "text",
"name": "text"
},
"seller": {
"id": "text",
"icon": "text",
"externalId": "text",
"name": "text"
},
"name": "text",
"companyName": "text",
"status": "text",
"note": "text",
"externalIds": {
"erpCompanyContact": "text",
"erpCustomer": "text",
"accountExternalId": "text"
},
"address": {
"addressLine1": "text",
"addressLine2": "text",
"postCode": "text",
"city": "text",
"state": "text",
"country": "text"
}
}
],
"Contact.Name": "text",
"Contact.FirstName": "text",
"Contact.LastName": "text",
"Contact.Email": "text",
"Contact.Phone.Prefix": "text",
"Contact.Phone.Number": "text",
"Contact.User.Email": "text",
"Contact.User.Status": "text",
"Contact.User.Phone.Prefix": "text",
"Contact.User.Phone.Number": "text",
"Contact.User.FirstName": "text",
"Contact.User.LastName": "text",
"Contact.User.Icon": "text",
"Contact.User.LastLoginAt": "2026-01-06T20:26:18.045Z",
"Contact.User.Settings.CultureCode": "text",
"Contact.User.Settings.LanguageCode": "text",
"Contact.User.Name": "text",
"Contact.User.Accounts": [
{
"id": "text",
"audit": {
"created": "[Circular Reference]",
"updated": "[Circular Reference]"
},
"$meta": {
"omitted": [
"text"
]
},
"icon": "text",
"externalIds": {
"pyraTenantId": "123e4567-e89b-12d3-a456-426614174000"
},
"externalId": "text",
"externalName": "text",
"type": "text",
"status": "text",
"serviceLevel": "text",
"address": {
"addressLine1": "text",
"addressLine2": "text",
"postCode": "text",
"city": "text",
"state": "text",
"country": "text"
},
"technicalSupportEmail": "text",
"website": "text",
"description": "text",
"name": "text",
"groups": [
{
"id": "text",
"name": "text",
"description": "text",
"logo": "text",
"isDefault": true
}
],
"eligibility": {
"client": true,
"partner": true
}
}
],
"Contact.User.CurrentAccount.ExternalIds.PyraTenantId": "123e4567-e89b-12d3-a456-426614174000",
"Contact.User.CurrentAccount.ExternalId": "text",
"Contact.User.CurrentAccount.ExternalName": "text",
"Contact.User.CurrentAccount.Type": "Client",
"Contact.User.CurrentAccount.Status": "Active",
"Contact.User.CurrentAccount.ServiceLevel": "Express",
"Contact.User.CurrentAccount.Address.AddressLine1": "text",
"Contact.User.CurrentAccount.Address.AddressLine2": "text",
"Contact.User.CurrentAccount.Address.PostCode": "text",
"Contact.User.CurrentAccount.Address.City": "text",
"Contact.User.CurrentAccount.Address.State": "text",
"Contact.User.CurrentAccount.Address.Country": "text",
"Contact.User.CurrentAccount.TechnicalSupportEmail": "text",
"Contact.User.CurrentAccount.Website": "text",
"Contact.User.CurrentAccount.Description": "text",
"Contact.User.CurrentAccount.Name": "text",
"Contact.User.CurrentAccount.Groups": [
{
"id": "text",
"audit": {
"created": "[Circular Reference]",
"updated": "[Circular Reference]"
},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"description": "text",
"account": {
"id": "text",
"icon": "text",
"type": "text",
"status": "text",
"name": "text"
},
"modules": [
{
"id": "text",
"description": "text",
"name": "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",
"icon": "text",
"name": "text"
}
],
"buyers": [
{
"id": "text",
"icon": "text",
"name": "text"
}
]
}
],
"Contact.User.CurrentAccount.Eligibility.Client": true,
"Contact.User.CurrentAccount.Eligibility.Partner": true,
"Contact.User.CurrentAccount.Icon": "text",
"Contact.User.CurrentAccount.Metadata.OmittedProperties": [
"text"
],
"Contact.User.CurrentAccount.Audit.Created.At": "2026-01-06T20:26:18.045Z",
"Contact.User.CurrentAccount.Audit.Created.ById": "text",
"Contact.User.CurrentAccount.Audit.Created.By.Name": "text",
"Contact.User.CurrentAccount.Audit.Created.By.Icon": "text",
"Contact.User.CurrentAccount.Audit.Created.By.HasIcon": true,
"Contact.User.CurrentAccount.Audit.Created.By.Type": "User",
"Contact.User.CurrentAccount.Audit.Created.By.Metadata.OmittedProperties": [
"text"
],
"Contact.User.CurrentAccount.Audit.Created.By.Audit.Created": {
"at": "2026-01-06T20:26:18.045Z",
"by": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
}
},
"Contact.User.CurrentAccount.Audit.Created.By.Audit.Updated.At": "2026-01-06T20:26:18.045Z",
"Contact.User.CurrentAccount.Audit.Created.By.Audit.Updated.ById": "text",
"Contact.User.CurrentAccount.Audit.Created.By.Audit.Updated.By": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
},
"Contact.User.CurrentAccount.Audit.Created.By.Id": "text",
"Contact.User.CurrentAccount.Audit.Created.By.SystemId": 1,
"Contact.User.CurrentAccount.Audit.Updated.At": "2026-01-06T20:26:18.045Z",
"Contact.User.CurrentAccount.Audit.Updated.ById": "text",
"Contact.User.CurrentAccount.Audit.Updated.By.Name": "text",
"Contact.User.CurrentAccount.Audit.Updated.By.Icon": "text",
"Contact.User.CurrentAccount.Audit.Updated.By.HasIcon": true,
"Contact.User.CurrentAccount.Audit.Updated.By.Type": "User",
"Contact.User.CurrentAccount.Audit.Updated.By.Metadata.OmittedProperties": [
"text"
],
"Contact.User.CurrentAccount.Audit.Updated.By.Audit.Created.At": "2026-01-06T20:26:18.045Z",
"Contact.User.CurrentAccount.Audit.Updated.By.Audit.Created.ById": "text",
"Contact.User.CurrentAccount.Audit.Updated.By.Audit.Created.By": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
},
"Contact.User.CurrentAccount.Audit.Updated.By.Audit.Updated": {
"at": "2026-01-06T20:26:18.045Z",
"by": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
}
},
"Contact.User.CurrentAccount.Audit.Updated.By.Id": "text",
"Contact.User.CurrentAccount.Audit.Updated.By.SystemId": 1,
"Contact.User.CurrentAccount.Id": "text",
"Contact.User.CurrentAccount.SystemId": 1,
"Contact.User.Metadata.OmittedProperties": [
"text"
],
"Contact.User.Audit.InvitationAcceptedAt": "2026-01-06T20:26:18.045Z",
"Contact.User.Audit.Created.At": "2026-01-06T20:26:18.045Z",
"Contact.User.Audit.Created.ById": "text",
"Contact.User.Audit.Created.By.Name": "text",
"Contact.User.Audit.Created.By.Icon": "text",
"Contact.User.Audit.Created.By.HasIcon": true,
"Contact.User.Audit.Created.By.Type": "User",
"Contact.User.Audit.Created.By.Metadata.OmittedProperties": [
"text"
],
"Contact.User.Audit.Created.By.Audit.Created.At": "2026-01-06T20:26:18.045Z",
"Contact.User.Audit.Created.By.Audit.Created.ById": "text",
"Contact.User.Audit.Created.By.Audit.Created.By": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
},
"Contact.User.Audit.Created.By.Audit.Updated.At": "2026-01-06T20:26:18.045Z",
"Contact.User.Audit.Created.By.Audit.Updated.ById": "text",
"Contact.User.Audit.Created.By.Audit.Updated.By": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
},
"Contact.User.Audit.Created.By.Id": "text",
"Contact.User.Audit.Created.By.SystemId": 1,
"Contact.User.Audit.Updated.At": "2026-01-06T20:26:18.045Z",
"Contact.User.Audit.Updated.ById": "text",
"Contact.User.Audit.Updated.By.Name": "text",
"Contact.User.Audit.Updated.By.Icon": "text",
"Contact.User.Audit.Updated.By.HasIcon": true,
"Contact.User.Audit.Updated.By.Type": "User",
"Contact.User.Audit.Updated.By.Metadata.OmittedProperties": [
"text"
],
"Contact.User.Audit.Updated.By.Audit.Created.At": "2026-01-06T20:26:18.045Z",
"Contact.User.Audit.Updated.By.Audit.Created.ById": "text",
"Contact.User.Audit.Updated.By.Audit.Created.By": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
},
"Contact.User.Audit.Updated.By.Audit.Updated.At": "2026-01-06T20:26:18.045Z",
"Contact.User.Audit.Updated.By.Audit.Updated.ById": "text",
"Contact.User.Audit.Updated.By.Audit.Updated.By": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
},
"Contact.User.Audit.Updated.By.Id": "text",
"Contact.User.Audit.Updated.By.SystemId": 1,
"Contact.User.Id": "text",
"Contact.User.SystemId": 1,
"Contact.Type": "text",
"Icon": "text",
"Metadata.OmittedProperties": [
"text"
],
"Audit.Activated.At": "2026-01-06T20:26:18.045Z",
"Audit.Activated.ById": "text",
"Audit.Activated.By.Name": "text",
"Audit.Activated.By.Icon": "text",
"Audit.Activated.By.HasIcon": true,
"Audit.Activated.By.Type": "User",
"Audit.Activated.By.Metadata.OmittedProperties": [
"text"
],
"Audit.Activated.By.Audit.Created.At": "2026-01-06T20:26:18.045Z",
"Audit.Activated.By.Audit.Created.ById": "text",
"Audit.Activated.By.Audit.Created.By": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
},
"Audit.Activated.By.Audit.Updated.At": "2026-01-06T20:26:18.045Z",
"Audit.Activated.By.Audit.Updated.ById": "text",
"Audit.Activated.By.Audit.Updated.By": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
},
"Audit.Activated.By.Id": "text",
"Audit.Activated.By.SystemId": 1,
"Audit.Unassigned.At": "2026-01-06T20:26:18.045Z",
"Audit.Unassigned.ById": "text",
"Audit.Unassigned.By.Name": "text",
"Audit.Unassigned.By.Icon": "text",
"Audit.Unassigned.By.HasIcon": true,
"Audit.Unassigned.By.Type": "User",
"Audit.Unassigned.By.Metadata.OmittedProperties": [
"text"
],
"Audit.Unassigned.By.Audit.Created.At": "2026-01-06T20:26:18.045Z",
"Audit.Unassigned.By.Audit.Created.ById": "text",
"Audit.Unassigned.By.Audit.Created.By": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
},
"Audit.Unassigned.By.Audit.Updated.At": "2026-01-06T20:26:18.045Z",
"Audit.Unassigned.By.Audit.Updated.ById": "text",
"Audit.Unassigned.By.Audit.Updated.By": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
},
"Audit.Unassigned.By.Id": "text",
"Audit.Unassigned.By.SystemId": 1,
"Audit.Disabled.At": "2026-01-06T20:26:18.045Z",
"Audit.Disabled.ById": "text",
"Audit.Disabled.By.Name": "text",
"Audit.Disabled.By.Icon": "text",
"Audit.Disabled.By.HasIcon": true,
"Audit.Disabled.By.Type": "User",
"Audit.Disabled.By.Metadata.OmittedProperties": [
"text"
],
"Audit.Disabled.By.Audit.Created.At": "2026-01-06T20:26:18.045Z",
"Audit.Disabled.By.Audit.Created.ById": "text",
"Audit.Disabled.By.Audit.Created.By": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
},
"Audit.Disabled.By.Audit.Updated.At": "2026-01-06T20:26:18.045Z",
"Audit.Disabled.By.Audit.Updated.ById": "text",
"Audit.Disabled.By.Audit.Updated.By": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
},
"Audit.Disabled.By.Id": "text",
"Audit.Disabled.By.SystemId": 1,
"Audit.Created.At": "2026-01-06T20:26:18.045Z",
"Audit.Created.ById": "text",
"Audit.Created.By.Name": "text",
"Audit.Created.By.Icon": "text",
"Audit.Created.By.HasIcon": true,
"Audit.Created.By.Type": "User",
"Audit.Created.By.Metadata.OmittedProperties": [
"text"
],
"Audit.Created.By.Audit.Created.At": "2026-01-06T20:26:18.045Z",
"Audit.Created.By.Audit.Created.ById": "text",
"Audit.Created.By.Audit.Created.By": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
},
"Audit.Created.By.Audit.Updated.At": "2026-01-06T20:26:18.045Z",
"Audit.Created.By.Audit.Updated.ById": "text",
"Audit.Created.By.Audit.Updated.By": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
},
"Audit.Created.By.Id": "text",
"Audit.Created.By.SystemId": 1,
"Audit.Updated.At": "2026-01-06T20:26:18.045Z",
"Audit.Updated.ById": "text",
"Audit.Updated.By.Name": "text",
"Audit.Updated.By.Icon": "text",
"Audit.Updated.By.HasIcon": true,
"Audit.Updated.By.Type": "User",
"Audit.Updated.By.Metadata.OmittedProperties": [
"text"
],
"Audit.Updated.By.Audit.Created.At": "2026-01-06T20:26:18.045Z",
"Audit.Updated.By.Audit.Created.ById": "text",
"Audit.Updated.By.Audit.Created.By": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
},
"Audit.Updated.By.Audit.Updated.At": "2026-01-06T20:26:18.045Z",
"Audit.Updated.By.Audit.Updated.ById": "text",
"Audit.Updated.By.Audit.Updated.By": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"name": "text",
"icon": "text"
},
"Audit.Updated.By.Id": "text",
"Audit.Updated.By.SystemId": 1,
"Id": "text",
"SystemId": 1
},
"logo": "binary"
}{
"id": "text",
"audit": {
"created": {
"at": "2026-01-06T20:26:18.045Z",
"by": {}
},
"updated": {
"at": "2026-01-06T20:26:18.045Z",
"by": {}
},
"activated": {
"at": "2026-01-06T20:26:18.045Z",
"by": {}
},
"unassigned": {
"at": "2026-01-06T20:26:18.045Z",
"by": {}
},
"disabled": {
"at": "2026-01-06T20:26:18.045Z",
"by": {}
}
},
"$meta": {
"omitted": [
"text"
]
},
"icon": "text",
"contact": {
"name": "text",
"firstName": "text",
"lastName": "text",
"email": "text",
"phone": {
"prefix": "text",
"number": "text"
},
"user": {
"id": "text",
"audit": {},
"$meta": {
"omitted": [
"text"
]
},
"email": "text",
"status": "text",
"phone": {
"prefix": "text",
"number": "text"
},
"firstName": "text",
"lastName": "text",
"icon": "text",
"lastLoginAt": "2026-01-06T20:26:18.045Z",
"settings": {
"cultureCode": "text",
"languageCode": "text"
},
"name": "text",
"accounts": [
{
"id": "text",
"icon": "text",
"type": "text",
"status": "text",
"name": "text"
}
],
"currentAccount": {
"id": "text",
"icon": "text",
"type": "text",
"status": "text",
"name": "text"
}
}
},
"externalIds": {
"erpCompanyContact": "text",
"erpCustomer": "text",
"accountExternalId": "text"
},
"status": "text",
"address": {
"addressLine1": "text",
"addressLine2": "text",
"postCode": "text",
"city": "text",
"state": "text",
"country": "text"
},
"taxId": "text",
"account": {
"id": "text",
"icon": "text",
"type": "text",
"status": "text",
"name": "text"
},
"name": "text",
"errors": [
{
"id": "text",
"message": "text",
"parameters": null
}
],
"sellers": [
{
"id": "text",
"icon": "text",
"externalId": "text",
"name": "text"
}
]
}