A new Transaction must have one Tier associated to it and that Tier must have at least one AgentCommission associated to it; you will receive a validation error if you send a Transaction object without that data.
Transaction.Number should be set to NULL unless the primary office for the transaction allows manual entry of a transaction number.
The response will contain the newly created transaction object populated with all of the data to which you have read access. You can use the OData $expand parameter to limit the data that is returned.
Please see the Creating and Updating Data section of the introduction for more information on how to set property values.
OData Support: $expand
Query parameters
-
Instructs the API to include a child object or collection in the response. If omitted, ALL child objects and collections are returned. Pass
$expand=(empty) to return only the root object. See the OData Support section of the introduction.
Body
Required
A Transaction object.
-
The Lone Wolf Id of the transaction. Required for updates only. It will be ignored when creating a new transaction.
Maximum length is
50. -
The transaction number. In most cases, the transaction number will be automatically generated. This is only required if the primary office for the trade allows manual transaction number entry and it has not setup a sequence for transaction numbers.
Maximum length is
15. -
The MLS number for the listing associated to the transaction.
Maximum length is
15. -
The Lone Wolf Id of the property type. This is an Id that is retrieved from the property types resource.
Maximum length is
50. -
The Lone Wolf Id of the classification. This is an Id that is retrieved from the classifications resource.
Maximum length is
50. -
The date the transaction was entered. This is not the date that the transaction record was created (though in most cases, it will be the same value). This is a client specified date. If not specified, then the current date is used.
-
The date the transaction closed.
-
The date an offer was made on the transaction.
-
The final sale price.
-
Any legal notices for the transaction.
Maximum length is
100. -
The MLS style address for the transaction. The $expand OData parameter will have no effect on this property; it will always be returned with the transaction data.
-
The list of different tiers for the transactions. At least 1 is required.
-
The list of client contacts for the transaction.
-
The list of business contacts for the transaction.
-
The list of conditions for the transaction.
-
The version of the record in the database.
Responses
-
The newly created Transaction object.
-
Error Code 1006: Validation failed. See the Details property of the response for information on why the validation failed. Error Code 1008: Invalid operation. This typically happens when you are trying to create an object without the required permission (eg. you don't have create permission for Conditions but you pass through a list of Conditions in the Transaction.Conditions property). See the Details property of the response for more information.
-
A child object was not found (eg. you attempt to set the classification of a transaction with a ClassificationId that does not exist).
curl \
--request POST 'https://api-sb.globalwolfweb.com/wolfconnect/transactions/v1' \
--header "Authorization: $API_KEY" \
--header "Content-Type: application/json" \
--data '{"Id":"string","Number":"string","MLSNumber":"string","PropertyTypeId":"string","ClassificationId":"string","EntryDate":"2026-05-04","CloseDate":"2026-05-04","OfferDate":"2026-05-04","SellPrice":42.0,"LegalDescription":"string","MLSAddress":{"StreetNumber":"string","StreetName":"string","StreetDirection":"string","Unit":"string","City":"string","ProvinceCode":"string","PostalCode":"string","CountryCode":"string"},"Tiers":[{"Id":"string","Name":"string","ClassificationId":"string","SellPrice":42.0,"CloseDate":"2026-05-04","AgentCommissions":[{"Id":"string","AgentId":"string","TeamLeaderId":"string","EndCode":"string","EndCount":42.0,"Commission":42.0,"RowVersion":42}],"ExternalAgentCommissions":[{"Id":"string","ExternalAgentId":"string","EndCode":"string","Commission":42.0,"ExternalAgent":{"Id":"string","CRMId":"string","CRMCompanyContactId":"string","FirstName":"string","MiddleName":"string","LastName":"string","ContactTypeId":"string","EndCode":"string","CompanyName":"string","Addresses":[{"City":"string","Confidential":true,"CountryCode":"string","Line1":"string","Line2":"string","Line3":"string","Line4":"string","PostalCode":"string","ProvinceCode":"string","TypeCode":"string"}],"PhoneNumbers":[{"Confidential":true,"Extension":"string","Number":"string","Primary":true,"TypeCode":"string"}],"EmailAddresses":[{"Address":"string","Confidential":true,"Primary":true,"TypeCode":"string"}],"RowVersion":42,"AddressTypeCode":"string"},"RowVersion":42}],"RowVersion":42}],"ClientContacts":[{"Id":"string","CRMId":"string","FirstName":"string","MiddleName":"string","LastName":"string","ContactTypeId":"string","Title":"string","Prefix":"string","Suffix":"string","CompanyName":"string","MarketingName":"string","NickName":"string","LegalName":"string","FormerName":"string","GenderCode":"string","SourceOfBusinessId":"string","Addresses":[{"City":"string","Confidential":true,"CountryCode":"string","Line1":"string","Line2":"string","Line3":"string","Line4":"string","PostalCode":"string","ProvinceCode":"string","TypeCode":"string"}],"PhoneNumbers":[{"Confidential":true,"Extension":"string","Number":"string","Primary":true,"TypeCode":"string"}],"EmailAddresses":[{"Address":"string","Confidential":true,"Primary":true,"TypeCode":"string"}],"RowVersion":42,"SendMovingWolfEmails":true}],"BusinessContacts":[{"Id":"string","CRMId":"string","CRMCompanyContactId":"string","FirstName":"string","MiddleName":"string","LastName":"string","ContactTypeId":"string","EndCode":"string","CompanyName":"string","Addresses":[{"City":"string","Confidential":true,"CountryCode":"string","Line1":"string","Line2":"string","Line3":"string","Line4":"string","PostalCode":"string","ProvinceCode":"string","TypeCode":"string"}],"PhoneNumbers":[{"Confidential":true,"Extension":"string","Number":"string","Primary":true,"TypeCode":"string"}],"EmailAddresses":[{"Address":"string","Confidential":true,"Primary":true,"TypeCode":"string"}],"RowVersion":42}],"Conditions":[{"Id":"string","Description":"string","DueDate":"2026-05-04","ApprovedDate":"2026-05-04","RowVersion":42}],"RowVersion":42}'
{
"Id": "string",
"Number": "string",
"MLSNumber": "string",
"PropertyTypeId": "string",
"ClassificationId": "string",
"EntryDate": "2026-05-04",
"CloseDate": "2026-05-04",
"OfferDate": "2026-05-04",
"SellPrice": 42.0,
"LegalDescription": "string",
"MLSAddress": {
"StreetNumber": "string",
"StreetName": "string",
"StreetDirection": "string",
"Unit": "string",
"City": "string",
"ProvinceCode": "string",
"PostalCode": "string",
"CountryCode": "string"
},
"Tiers": [
{
"Id": "string",
"Name": "string",
"ClassificationId": "string",
"SellPrice": 42.0,
"CloseDate": "2026-05-04",
"AgentCommissions": [
{
"Id": "string",
"AgentId": "string",
"TeamLeaderId": "string",
"EndCode": "string",
"EndCount": 42.0,
"Commission": 42.0,
"RowVersion": 42
}
],
"ExternalAgentCommissions": [
{
"Id": "string",
"ExternalAgentId": "string",
"EndCode": "string",
"Commission": 42.0,
"ExternalAgent": {
"Id": "string",
"CRMId": "string",
"CRMCompanyContactId": "string",
"FirstName": "string",
"MiddleName": "string",
"LastName": "string",
"ContactTypeId": "string",
"EndCode": "string",
"CompanyName": "string",
"Addresses": [
{
"City": "string",
"Confidential": true,
"CountryCode": "string",
"Line1": "string",
"Line2": "string",
"Line3": "string",
"Line4": "string",
"PostalCode": "string",
"ProvinceCode": "string",
"TypeCode": "string"
}
],
"PhoneNumbers": [
{
"Confidential": true,
"Extension": "string",
"Number": "string",
"Primary": true,
"TypeCode": "string"
}
],
"EmailAddresses": [
{
"Address": "string",
"Confidential": true,
"Primary": true,
"TypeCode": "string"
}
],
"RowVersion": 42,
"AddressTypeCode": "string"
},
"RowVersion": 42
}
],
"RowVersion": 42
}
],
"ClientContacts": [
{
"Id": "string",
"CRMId": "string",
"FirstName": "string",
"MiddleName": "string",
"LastName": "string",
"ContactTypeId": "string",
"Title": "string",
"Prefix": "string",
"Suffix": "string",
"CompanyName": "string",
"MarketingName": "string",
"NickName": "string",
"LegalName": "string",
"FormerName": "string",
"GenderCode": "string",
"SourceOfBusinessId": "string",
"Addresses": [
{
"City": "string",
"Confidential": true,
"CountryCode": "string",
"Line1": "string",
"Line2": "string",
"Line3": "string",
"Line4": "string",
"PostalCode": "string",
"ProvinceCode": "string",
"TypeCode": "string"
}
],
"PhoneNumbers": [
{
"Confidential": true,
"Extension": "string",
"Number": "string",
"Primary": true,
"TypeCode": "string"
}
],
"EmailAddresses": [
{
"Address": "string",
"Confidential": true,
"Primary": true,
"TypeCode": "string"
}
],
"RowVersion": 42,
"SendMovingWolfEmails": true
}
],
"BusinessContacts": [
{
"Id": "string",
"CRMId": "string",
"CRMCompanyContactId": "string",
"FirstName": "string",
"MiddleName": "string",
"LastName": "string",
"ContactTypeId": "string",
"EndCode": "string",
"CompanyName": "string",
"Addresses": [
{
"City": "string",
"Confidential": true,
"CountryCode": "string",
"Line1": "string",
"Line2": "string",
"Line3": "string",
"Line4": "string",
"PostalCode": "string",
"ProvinceCode": "string",
"TypeCode": "string"
}
],
"PhoneNumbers": [
{
"Confidential": true,
"Extension": "string",
"Number": "string",
"Primary": true,
"TypeCode": "string"
}
],
"EmailAddresses": [
{
"Address": "string",
"Confidential": true,
"Primary": true,
"TypeCode": "string"
}
],
"RowVersion": 42
}
],
"Conditions": [
{
"Id": "string",
"Description": "string",
"DueDate": "2026-05-04",
"ApprovedDate": "2026-05-04",
"RowVersion": 42
}
],
"RowVersion": 42
}
{
"Id": "string",
"Number": "string",
"MLSNumber": "string",
"PropertyTypeId": "string",
"PropertyType": {
"Id": "string",
"LWCompanyCode": "string",
"Code": "string",
"Name": "string",
"Default": true,
"ClassCode": "string",
"Class": "string",
"InactiveDate": "2026-05-04"
},
"ClassificationId": "string",
"Classification": {
"Id": "string",
"LWCompanyCode": "string",
"Code": "string",
"Name": "string",
"EndCount": 42.0,
"InactiveDate": "2026-05-04"
},
"StatusCode": "string",
"Status": "string",
"EntryDate": "2026-05-04",
"CloseDate": "2026-05-04",
"OfferDate": "2026-05-04",
"SellPrice": 42.0,
"LegalDescription": "string",
"MLSAddress": {
"StreetNumber": "string",
"StreetName": "string",
"StreetDirection": "string",
"Unit": "string",
"City": "string",
"ProvinceCode": "string",
"Province": "string",
"PostalCode": "string",
"CountryCode": "string",
"Country": "string"
},
"Tiers": [
{
"Id": "string",
"Name": "string",
"ClassificationId": "string",
"Classification": {
"Id": "string",
"LWCompanyCode": "string",
"Code": "string",
"Name": "string",
"EndCount": 42.0,
"InactiveDate": "2026-05-04"
},
"StatusCode": "string",
"Status": "string",
"SellPrice": 42.0,
"CloseDate": "2026-05-04",
"SellingCommission": 42.0,
"BuyingCommission": 42.0,
"TotalCommission": 42.0,
"AgentCommissions": [
{
"Id": "string",
"AgentId": "string",
"TeamLeaderId": "string",
"EndCode": "string",
"End": "string",
"EndCount": 42.0,
"CommissionPercentage": 42.0,
"Commission": 42.0,
"Agent": {
"Id": "string",
"OfficeId": "string",
"FirstName": "string",
"MiddleName": "string",
"LastName": "string"
},
"TeamLeader": {
"Id": "string",
"OfficeId": "string",
"FirstName": "string",
"MiddleName": "string",
"LastName": "string"
},
"CreatedTimestamp": "2026-05-04T09:42:00Z",
"ModifiedTimestamp": "2026-05-04T09:42:00Z",
"RowVersion": 42
}
],
"ExternalAgentCommissions": [
{
"Id": "string",
"ExternalAgentId": "string",
"EndCode": "string",
"End": "string",
"Commission": 42.0,
"ExternalAgent": {
"Id": "string",
"CRMId": "string",
"CRMCompanyContactId": "string",
"FirstName": "string",
"MiddleName": "string",
"LastName": "string",
"ContactTypeId": "string",
"ContactType": {
"Id": "string",
"LWCompanyCode": "string",
"Code": "string",
"Name": "string",
"CategoryCode": "string",
"InactiveDate": "2026-05-04"
},
"EndCode": "string",
"End": "string",
"CompanyName": "string",
"Addresses": [
{
"City": "string",
"Confidential": true,
"Country": "string",
"CountryCode": "string",
"Line1": "string",
"Line2": "string",
"Line3": "string",
"Line4": "string",
"PostalCode": "string",
"Province": "string",
"ProvinceCode": "string",
"Type": "string",
"TypeCode": "string"
}
],
"PhoneNumbers": [
{
"Confidential": true,
"Extension": "string",
"Number": "string",
"Primary": true,
"Type": "string",
"TypeCode": "string"
}
],
"EmailAddresses": [
{
"Address": "string",
"Confidential": true,
"Primary": true,
"Type": "string",
"TypeCode": "string"
}
],
"RowVersion": 42,
"AddressTypeCode": "string"
},
"CreatedTimestamp": "2026-05-04T09:42:00Z",
"ModifiedTimestamp": "2026-05-04T09:42:00Z",
"RowVersion": 42
}
],
"CreatedTimestamp": "2026-05-04T09:42:00Z",
"ModifiedTimestamp": "2026-05-04T09:42:00Z",
"RowVersion": 42
}
],
"ClientContacts": [
{
"Id": "string",
"CRMId": "string",
"FirstName": "string",
"MiddleName": "string",
"LastName": "string",
"ContactTypeId": "string",
"ContactType": {
"Id": "string",
"LWCompanyCode": "string",
"Code": "string",
"Name": "string",
"CategoryCode": "string",
"InactiveDate": "2026-05-04"
},
"Title": "string",
"Prefix": "string",
"Suffix": "string",
"CompanyName": "string",
"MarketingName": "string",
"NickName": "string",
"LegalName": "string",
"FormerName": "string",
"GenderCode": "string",
"Gender": "string",
"SourceOfBusinessId": "string",
"SourceOfBusiness": {
"Id": "string",
"LWCompanyCode": "string",
"Code": "string",
"Name": "string",
"InactiveDate": "2026-05-04"
},
"Addresses": [
{
"City": "string",
"Confidential": true,
"Country": "string",
"CountryCode": "string",
"Line1": "string",
"Line2": "string",
"Line3": "string",
"Line4": "string",
"PostalCode": "string",
"Province": "string",
"ProvinceCode": "string",
"Type": "string",
"TypeCode": "string"
}
],
"PhoneNumbers": [
{
"Confidential": true,
"Extension": "string",
"Number": "string",
"Primary": true,
"Type": "string",
"TypeCode": "string"
}
],
"EmailAddresses": [
{
"Address": "string",
"Confidential": true,
"Primary": true,
"Type": "string",
"TypeCode": "string"
}
],
"CreatedTimestamp": "2026-05-04T09:42:00Z",
"ModifiedTimestamp": "2026-05-04T09:42:00Z",
"RowVersion": 42,
"SendMovingWolfEmails": true,
"ShouldReceiveMovingWolfEmails": true,
"MovingWolfEmailsSendingAgentId": 42
}
],
"BusinessContacts": [
{
"Id": "string",
"CRMId": "string",
"CRMCompanyContactId": "string",
"FirstName": "string",
"MiddleName": "string",
"LastName": "string",
"ContactTypeId": "string",
"ContactType": {
"Id": "string",
"LWCompanyCode": "string",
"Code": "string",
"Name": "string",
"CategoryCode": "string",
"InactiveDate": "2026-05-04"
},
"EndCode": "string",
"End": "string",
"CompanyName": "string",
"Addresses": [
{
"City": "string",
"Confidential": true,
"Country": "string",
"CountryCode": "string",
"Line1": "string",
"Line2": "string",
"Line3": "string",
"Line4": "string",
"PostalCode": "string",
"Province": "string",
"ProvinceCode": "string",
"Type": "string",
"TypeCode": "string"
}
],
"PhoneNumbers": [
{
"Confidential": true,
"Extension": "string",
"Number": "string",
"Primary": true,
"Type": "string",
"TypeCode": "string"
}
],
"EmailAddresses": [
{
"Address": "string",
"Confidential": true,
"Primary": true,
"Type": "string",
"TypeCode": "string"
}
],
"CreatedTimestamp": "2026-05-04T09:42:00Z",
"ModifiedTimestamp": "2026-05-04T09:42:00Z",
"RowVersion": 42
}
],
"Conditions": [
{
"Id": "string",
"Description": "string",
"DueDate": "2026-05-04",
"ApprovedDate": "2026-05-04",
"CreatedTimestamp": "2026-05-04T09:42:00Z",
"ModifiedTimestamp": "2026-05-04T09:42:00Z",
"RowVersion": 42
}
],
"Task": [
{
"Id": "string",
"LoadingDocsTaskId": "string",
"Title": "string",
"DueDate": "2026-05-04",
"Reminder": true,
"ReminderSentTimestamp": "2026-05-04T09:42:00Z",
"CompletedDate": "2026-05-04",
"CreatedTimestamp": "2026-05-04T09:42:00Z",
"ModifiedTimestamp": "2026-05-04T09:42:00Z",
"RowVersion": 42
}
],
"CreatedTimestamp": "2026-05-04T09:42:00Z",
"ModifiedTimestamp": "2026-05-04T09:42:00Z",
"TransactionChangedTimestamp": "2026-05-04T09:42:00Z",
"RowVersion": 42
}
{
"Code": 42,
"Message": "string",
"Details": "string"
}
{
"Code": 42,
"Message": "string",
"Details": "string"
}