> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Contact

> This endpoint gets or creates a new contact.

### Body

<ParamField body="id" name="user_group_id" type="text" required="true">
  The ID of the user group to which the contact belongs.
</ParamField>

### Response

<ResponseField name="id" type="text">
  The ID of the contact.
</ResponseField>

<ResponseField name="assistant" type="text">
  Name or details of the assistant associated with the contact.
</ResponseField>

<ResponseField name="assistant_phone" type="text">
  Phone number of the assistant.
</ResponseField>

<ResponseField name="avatar" type="text">
  URL or path to the contact's avatar image.
</ResponseField>

<ResponseField name="birthdate" type="text">
  Date of birth of the contact.
</ResponseField>

<ResponseField name="controller" type="text">
  Name or details of the controller associated with the contact.
</ResponseField>

<ResponseField name="created_at" type="datetime">
  Date and time when the contact was created.
</ResponseField>

<ResponseField name="created_by" type="text">
  Name or details of the person who created the contact.
</ResponseField>

<ResponseField name="department" type="text">
  Department or division associated with the contact.
</ResponseField>

<ResponseField name="description" type="text">
  Description or additional details about the contact.
</ResponseField>

<ResponseField name="do_not_call" type="boolean">
  Indicates whether the contact should not be called.
</ResponseField>

<ResponseField name="email" type="text">
  Email address of the contact.
</ResponseField>

<ResponseField name="email_opt_out" type="boolean">
  Indicates whether the contact has opted out of email communication.
</ResponseField>

<ResponseField name="fax" type="text">
  Fax number of the contact.
</ResponseField>

<ResponseField name="fax_opt_out" type="boolean">
  Indicates whether the contact has opted out of fax communication.
</ResponseField>

<ResponseField name="firstName" type="text">
  First name of the contact.
</ResponseField>

<ResponseField name="handle" type="text">
  Handle or username associated with the contact.
</ResponseField>

<ResponseField name="invalid_contact" type="boolean">
  Indicates whether the contact is marked as invalid.
</ResponseField>

<ResponseField name="languages" type="text">
  Languages known or spoken by the contact.
</ResponseField>

<ResponseField name="lastName" type="text">
  Last name of the contact.
</ResponseField>

<ResponseField name="last_modified_by" type="text">
  Last person who modified the contact.
</ResponseField>

<ResponseField name="leadSource" type="text">
  Source or origin of the lead/contact.
</ResponseField>

<ResponseField name="mailingCity" type="text">
  City of the mailing address.
</ResponseField>

<ResponseField name="mailingCountry" type="text">
  Country of the mailing address.
</ResponseField>

<ResponseField name="mailingGeocodeAccuracy" type="text">
  Geocoding accuracy of the mailing address.
</ResponseField>

<ResponseField name="mailingState" type="text">
  State or province of the mailing address.
</ResponseField>

<ResponseField name="mailingStreet" type="text">
  Street of the mailing address.
</ResponseField>

<ResponseField name="owner" type="text">
  Name or details of the owner of the contact.
</ResponseField>

<ResponseField name="phone" type="text">
  Phone number of the contact.
</ResponseField>

<ResponseField name="photoUrl" type="text">
  URL or path to the contact's photo.
</ResponseField>

<ResponseField name="processor" type="text">
  Name or details of the processor associated with the contact.
</ResponseField>

<ResponseField name="title" type="text">
  Title or position of the contact.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request GET 'https://api.stateset.com/v1/contacts/:id' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Token <token>' \
  --data-raw '{
      "id": "example_1",
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": 1,
    "new_user_group": true,
    "user_group": {
      "team_id": 3,
      "token": "<user_group_token_to_auth_dashboard>",
      "name": "Example 1",
      "provided_id": "example_1"
    }
  }
  ```
</ResponseExample>

| Name                   | Type      | Description                                                        |
| ---------------------- | --------- | ------------------------------------------------------------------ |
| id                     | Text      | Unique identifier for the contact                                  |
| assistant              | Text      | Name or details of the assistant associated with the contact       |
| assistant\_phone       | Text      | Phone number of the assistant                                      |
| avatar                 | Text      | URL or path to the contact's avatar image                          |
| birthdate              | Text      | Date of birth of the contact                                       |
| controller             | Text      | Name or details of the controller associated with the contact      |
| created\_at            | Date/Time | Date and time when the contact was created                         |
| created\_by            | Text      | Name or details of the person who created the contact              |
| department             | Text      | Department or division associated with the contact                 |
| description            | Text      | Description or additional details about the contact                |
| do\_not\_call          | Boolean   | Indicates whether the contact should not be called                 |
| email                  | Text      | Email address of the contact                                       |
| email\_opt\_out        | Boolean   | Indicates whether the contact has opted out of email communication |
| fax                    | Text      | Fax number of the contact                                          |
| fax\_opt\_out          | Boolean   | Indicates whether the contact has opted out of fax communication   |
| firstName              | Text      | First name of the contact                                          |
| handle                 | Text      | Handle or username associated with the contact                     |
| invalid\_contact       | Boolean   | Indicates whether the contact is marked as invalid                 |
| languages              | Text      | Languages known or spoken by the contact                           |
| lastName               | Text      | Last name of the contact                                           |
| last\_modified\_by     | Text      | Last person who modified the contact                               |
| leadSource             | Text      | Source or origin of the lead/contact                               |
| mailingCity            | Text      | City of the mailing address                                        |
| mailingCountry         | Text      | Country of the mailing address                                     |
| mailingGeocodeAccuracy | Text      | Geocoding accuracy of the mailing address                          |
| mailingState           | Text      | State or province of the mailing address                           |
| mailingStreet          | Text      | Street address of the mailing address                              |
| nextMeeting            | Text      | Details or date/time of the next scheduled meeting                 |
| owner                  | Text      | Owner or responsible person for the contact                        |
| phone                  | Text      | Phone number of the contact                                        |
| photoUrl               | Text      | URL or path to the contact's photo/image                           |
| processor              | Text      | Name or details of the processor associated with the contact       |
| supplier\_id           | Text      | Supplier ID associated with the contact                            |
| title                  | Text      | Title or job position of the contact                               |