3rd-Party Contact Search

POST /:account/integrations/contact_search{?provider,q}

If searching for a Contact within TextUs provides no results, a User may want to search for contacts within any integrated ATS or CMS applications that have been configured. This endpoint provides a common interface to the various Integrations that support searching, and also maps the results into the Contact type.

Examples

Searching Bullhorn Candidates

Request

POST /my_account/integrations/contact_search?provider=bullhorn&q=3035551000

Example

$ curl -i -H Accept:"application/vnd.textus+jsonld" \
    -H Authorization:"Bearer {token}" \
    -X POST /my_account/integrations/contact_search?provider=bullhorn&q=3035551000
    

Response

Status

200

Response Type

hydra:Collection

Example Body

{
  "@context": "/contexts/hydra:Collection.jsonld",
  "@type": "hydra:Collection",
  "id": "/my_account/integrations/contact_search?provider=bullhorn&q=3035551000",
  "members": [
    {
      "@context": "/contexts/Contact.jsonld",
      "@type": "Contact",
      "id": "/contacts/bullhorn-Candidate-1",
      "firstName": "Chuck",
      "lastName": "Norris",
      "name": "Chuck Norris",
      "data": {
        "bullhorn": {
          "Candidate": {
            "companyName": "Texas Rangers",
            "email": "chuck@rangers.example",
            "firstName": "Chuck",
            "id": 42,
            "lastName": "Norris",
            "mobile": null,
            "name": "Chuck Norris",
            "phone": "3035551000",
            "phone2": null,
            "phone3": null,
            "status": "Active",
            "workPhone": null,
            "namePrefix": null,
            "occupation": "Texas Ranger",
            "owner": {
              "firstName": "Product",
              "id": 73,
              "lastName": "Team"
            },
            "dateLastModified": 1657917183309
          }
        }
      },
      "formattedData": {
        "bullhorn": {
          "candidate": {
            "companyName": "Texas Rangers",
            "email": "chuck@rangers.example",
            "firstName": "Chuck",
            "id": 42,
            "lastName": "Norris",
            "mobile": null,
            "name": "Chuck Norris",
            "phone": "3035551000",
            "phone2": null,
            "phone3": null,
            "status": "Active",
            "workPhone": null,
            "namePrefix": null,
            "occupation": "Texas Ranger",
            "owner": {
              "firstName": "Product",
              "id": 73,
              "lastName": "Team"
            },
            "dateLastModified": 1657917183309
          }
        }
      },
      "notes": {
        "@context": "/contexts/hydra:Collection.jsonld",
        "@type": "hydra:Collection",
        "id": "/contacts/bullhorn-Candidate-1/notes",
        "members": [],
        "totalItems": 0
      },
      "phones": {
        "@context": "/contexts/hydra:Collection.jsonld",
        "@type": "hydra:Collection",
        "id": "/contacts/bullhorn-Candidate-1/phones",
        "members": [
          {
            "@context": "/contexts/ContactPhone.jsonld",
            "@type": "ContactPhone",
            "contact": "/contacts/AlQX1N",
            "deliverabilityStatus": null,
            "extension": null,
            "formattedPhoneNumber": "(303) 555-1000",
            "id": "/contact_phones/bullhorn-Candidate-Phone-phone",
            "phoneNumber": "+13035551000",
            "type": "phone"
          }
        ],
        "totalItems": 1
      },
      "createdAt": null,
      "conversations": "/contacts/bullhorn-Candidate-1/conversations"
    }
  ],
  "totalItems": 1
}