Create a contact

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://apidocs.lwolf.com/doc/transact-api/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Transact API MCP server": {
    "url": "https://apidocs.lwolf.com/doc/transact-api/mcp"
  }
}
Close
POST /transact-workflow/v1/Contacts
Bearer auth & Subscription key

Creates a new contact on a transaction for the user specified in the request body.

application/json

Body Required

Payload for creating a new transaction contact.

  • userId string(uuid) Required

    GUID of the user creating the contact.

  • transactionId string(uuid) Required

    GUID of the transaction the contact belongs to.

  • contactType integer

    Contact type code identifying the contact's role on the transaction.

    Value Contact type
    0 Buyer
    1 Seller
    2 BuyerAgent
    3 Other
    4 SellerAgent
    5 AppraisalCompany
    6 BuyerLawyer
    7 BuyerBroker
    8 CondoAssociationHOA
    9 EscrowCompany
    10 Landlord
    11 SellerBroker
    12 MortgageAppraiser
    13 BuyerLendingCompany
    14 SellerLawyer
    15 Tenant
    16 TitleCompany
    17 Admin
    18 SellerLendingCompany
    19 DisclosureCompany
    20 HomeWarrantyCompany
    21 PestControlCompany

    Values are 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, or 21.

  • slot integer

    Determines the ordering of contacts of the same type: 1 = Buyer 1 / Seller 1, 2 = Buyer 2 / Seller 2, and so on.

    Minimum value is 1.

  • prefix string

    Name prefix (e.g. Mr., Dr.).

  • suffix string

    Name suffix (e.g. Jr.).

  • firstname string

    First name.

  • middlename string

    Middle name.

  • lastname string

    Last name.

  • email string(email)

    Email address.

  • phone string

    Primary phone number.

  • cellPhone string

    Cell phone number.

  • workPhone string

    Work phone number.

  • fax string

    Fax number.

  • agentId string

    Agent identifier.

  • agentLicense string

    Agent license number.

  • companyName string

    Company name.

  • officeId string

    Office identifier.

  • officeLicense string

    Office license number.

  • escrowNumber string

    Escrow number.

  • address1 string

    Street address, line 1.

  • address2 string

    Street address, line 2.

  • address3 string

    Street address, line 3.

  • address4 string

    Street address, line 4.

  • locality string

    City / locality.

  • region string

    State or province.

  • postalCode string

    Postal / ZIP code.

  • country string

    Country.

  • llcPoa string

    LLC / power of attorney designation.

Responses

  • 201

    Contact created.

  • 400 application/json

    The request is malformed or contains invalid parameters.

    Hide response attributes Show response attributes object
    • error string

      Error code or short error name.

    • message string

      Human-readable error description.
  • 401 application/json

    The access token is missing, invalid, or expired.

    Hide response attributes Show response attributes object
    • error string

      Error code or short error name.

    • message string

      Human-readable error description.
  • 403 application/json

    The caller is not permitted to perform this operation.

    Hide response attributes Show response attributes object
    • error string

      Error code or short error name.

    • message string

      Human-readable error description.
  • 404 application/json

    The requested resource does not exist.

    Hide response attributes Show response attributes object
    • error string

      Error code or short error name.

    • message string

      Human-readable error description.
POST /transact-workflow/v1/Contacts 
curl \
 --request POST 'https://api.pre.lwolf.com/transact-workflow/v1/Contacts' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "lw-subscription-key: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"userId":"string","transactionId":"string","contactType":0,"slot":1,"prefix":"string","suffix":"string","firstname":"string","middlename":"string","lastname":"string","email":"hello@example.com","phone":"string","cellPhone":"string","workPhone":"string","fax":"string","agentId":"string","agentLicense":"string","companyName":"string","officeId":"string","officeLicense":"string","escrowNumber":"string","address1":"string","address2":"string","address3":"string","address4":"string","locality":"string","region":"string","postalCode":"string","country":"string","llcPoa":"string"}'
Request examples 
{
  "userId": "string",
  "transactionId": "string",
  "contactType": 0,
  "slot": 1,
  "prefix": "string",
  "suffix": "string",
  "firstname": "string",
  "middlename": "string",
  "lastname": "string",
  "email": "hello@example.com",
  "phone": "string",
  "cellPhone": "string",
  "workPhone": "string",
  "fax": "string",
  "agentId": "string",
  "agentLicense": "string",
  "companyName": "string",
  "officeId": "string",
  "officeLicense": "string",
  "escrowNumber": "string",
  "address1": "string",
  "address2": "string",
  "address3": "string",
  "address4": "string",
  "locality": "string",
  "region": "string",
  "postalCode": "string",
  "country": "string",
  "llcPoa": "string"
}
Response examples (400) 
{
  "error": "string",
  "message": "string"
}
Response examples (401) 
{
  "error": "string",
  "message": "string"
}
Response examples (403) 
{
  "error": "string",
  "message": "string"
}
Response examples (404) 
{
  "error": "string",
  "message": "string"
}