PATCH /v1/:facility_id/tenants/:id
Update a tenant

PUT /v1/:facility_id/tenants/:id
Update a tenant

Examples

PUT /v1/017f8870-44d0-46ae-b2ac-bfec8c1faf85/tenants/78cc61ec-9f63-4988-9b81-dfd6cce52038
{
  "tenant": {
    "first_name": "Kelvin",
    "last_name": "Benjamin",
    "mailing_address_attributes": {
      "address1": "Ikea St",
      "city": "Ikealand",
      "state": "KS"
    },
    "phone_numbers_attributes": [
      {
        "label": "Mobile",
        "number": "5656663476",
        "sms_opt_in": "true"
      }
    ]
  }
}
200
{
  "tenant": {
    "id": "78cc61ec-9f63-4988-9b81-dfd6cce52038",
    "account_number": 1000000,
    "first_name": "Kelvin",
    "last_name": "Benjamin",
    "middle_initial": null,
    "email": "elishahansen@murazik.net75",
    "tax_exempt": false,
    "is_military": false,
    "is_business": false,
    "business_name": null,
    "last_sign_in_at": null,
    "title": null,
    "delinquent": false,
    "current_ledger_ids": [
      "a5282b86-b325-48c3-a199-6fba60193140"
    ],
    "preferences": {
      "email_invoices": true,
      "print_invoices": false,
      "charge_invoice_fee": true,
      "receive_legal_notices_by_email": null,
      "delinquency_exempt": false,
      "delinquency_docs_by_email": false,
      "delinquency_docs_by_mail": false,
      "receive_sms_for_gate_activity": false,
      "opt_in_to_marketing_emails": false,
      "opt_in_to_marketing_sms": false,
      "opt_in_to_transactional_sms": false,
      "exclude_from_insurance_auto_enroll": false,
      "exclude_from_insurance_auto_enroll_reason": null,
      "exclude_from_insurance_auto_enroll_created_by": null,
      "exclude_from_insurance_auto_enroll_on": null
    },
    "military_information": null,
    "username": "username_75",
    "drivers_license_number": null,
    "drivers_license_state": null,
    "vehicle_license_plate_number": null,
    "vehicle_license_state": null,
    "vehicle_description": null,
    "has_tenant_portal_account": false,
    "created_at": "2022-09-12T22:36:45.896-10:00",
    "gate_24_hour_access": false,
    "active": true,
    "tenant_account_kind_name": "Standard",
    "blocked_payments": false,
    "date_of_birth": null,
    "phone_numbers": [
      {
        "id": "7f54b3e8-b773-4264-941d-e1fc2208487a",
        "primary": true,
        "source": null,
        "number": "+15707341455",
        "formatted_number": "(570) 734-1455 x 5237",
        "extension": "5237",
        "label": "Home",
        "unformatted_number": "5707341455",
        "sms_opt_in": false
      },
      {
        "id": "82bb506c-5425-4cc1-89d9-66c2273160d9",
        "primary": false,
        "source": null,
        "number": "+16197759199",
        "formatted_number": "(619) 775-9199 x 2097",
        "extension": "2097",
        "label": "Fax",
        "unformatted_number": "6197759199",
        "sms_opt_in": false
      },
      {
        "id": "c8aa1c63-9345-4cf4-9982-3d45b9a4fbc7",
        "primary": false,
        "source": null,
        "number": "+17542122773",
        "formatted_number": "(754) 212-2773 x 2929",
        "extension": "2929",
        "label": "Pager",
        "unformatted_number": "7542122773",
        "sms_opt_in": false
      },
      {
        "id": null,
        "primary": false,
        "source": null,
        "number": "+15656663476",
        "formatted_number": "(565) 666-3476",
        "extension": null,
        "label": "Mobile",
        "unformatted_number": "5656663476",
        "sms_opt_in": true
      }
    ],
    "mailing_address": {
      "id": "589229c0-155a-4dfe-9897-9fc6d89ef9a5",
      "address1": "Ikea St",
      "address2": null,
      "city": "Ikealand",
      "state": "KS",
      "postal": "39384",
      "country": "US",
      "full_address": "Ikea St, Ikealand, KS 39384",
      "latitude": 39.114844,
      "longitude": -94.630169,
      "time_zone_id": "America/Chicago",
      "time_zone_offset": "-05:00",
      "invalid_data": false,
      "label": "Home"
    },
    "addresses": [
      {
        "id": "589229c0-155a-4dfe-9897-9fc6d89ef9a5",
        "address1": "Ikea St",
        "address2": null,
        "city": "Ikealand",
        "state": "KS",
        "postal": "39384",
        "country": "US",
        "full_address": "Ikea St, Ikealand, KS 39384",
        "latitude": 39.114844,
        "longitude": -94.630169,
        "time_zone_id": "America/Chicago",
        "time_zone_offset": "-05:00",
        "invalid_data": false,
        "label": "Home"
      },
      {
        "id": "589229c0-155a-4dfe-9897-9fc6d89ef9a5",
        "address1": "Ikea St",
        "address2": null,
        "city": "Ikealand",
        "state": "KS",
        "postal": "39384",
        "country": "US",
        "full_address": "Ikea St, Ikealand, KS 39384",
        "latitude": 39.114844,
        "longitude": -94.630169,
        "time_zone_id": "America/Chicago",
        "time_zone_offset": "-05:00",
        "invalid_data": false,
        "label": "Home"
      }
    ],
    "facility_id": "017f8870-44d0-46ae-b2ac-bfec8c1faf85",
    "previous_ledger_ids": [],
    "lead_ids": [],
    "closed_lead_ids": [],
    "contact_ids": [],
    "support_case_ids": [],
    "event_ids": [
      "8e7249fd-01d5-4974-a905-fd3c3abf3cfb"
    ],
    "password_recovery_question_ids": [
      "de7d1e7a-ef5b-4ea8-b77a-a083944330d6",
      "940880bb-acbe-4db0-969f-e81e1b6110d7"
    ]
  },
  "meta": {
    "status_code": 200,
    "status_message": "OK",
    "status_cat": "https://http.cat/200",
    "request_method": "PUT",
    "request_id": null,
    "parameters": {
      "tenant": {
        "first_name": "Kelvin",
        "last_name": "Benjamin",
        "mailing_address_attributes": {
          "address1": "Ikea St",
          "city": "Ikealand",
          "state": "KS"
        },
        "phone_numbers_attributes": [
          {
            "label": "Mobile",
            "number": "5656663476",
            "sms_opt_in": "true"
          }
        ]
      },
      "facility_id": "017f8870-44d0-46ae-b2ac-bfec8c1faf85",
      "id": "78cc61ec-9f63-4988-9b81-dfd6cce52038"
    }
  }
}

Params

Param name Description
tenant
optional
Value: Must be a Hash
tenant[first_name]
optional
Value: Must be a String
tenant[account_number]
optional
Value: Must be a String
tenant[middle_initial]
optional
Value: Must be a String
tenant[last_name]
optional
Value: Must be a String
tenant[drivers_license_number]
optional
Value: Must be a String
tenant[drivers_license_state]
optional
Value: Must be a String
tenant[vehicle_license_plate_number]
optional
Value: Must be a String
tenant[vehicle_license_state]
optional
Value: Must be a String
tenant[vehicle_description]
optional
Value: Must be a String
tenant[email]
optional
Value: Must be a String
tenant[username]
optional
Value: Must be a String
tenant[password]
optional
Value: Must be a String
tenant[tax_exempt]
optional

Is the tenant tax exempt?


Value: Must be one of: <code>true</code>, <code>false</code>.
tenant[is_military]
optional

Is the tenant military?


Value: Must be one of: <code>true</code>, <code>false</code>.
tenant[is_business]
optional

Is the tenant a business?


Value: Must be one of: <code>true</code>, <code>false</code>.
tenant[business_name]
optional
Value: Must be a String
tenant[title]
optional
Value: Must be a String
tenant[decline_alternate_contact]
optional

Whether or not the tenant declined to provide alternate contact information


Value: Must be one of: <code>true</code>, <code>false</code>.
tenant[military_information]
optional

A collection of military information (if is_military is true).


Value: Must be a Hash
tenant[military_information][retired_military]
optional

Is the tenant retired military?


Value: Must be one of: <code>true</code>, <code>false</code>.
tenant[military_information][no_agent_given]
optional

Is agent information provided?


Value: Must be one of: <code>true</code>, <code>false</code>.
tenant[military_information][date_entered_service]
optional

Date entered service, Format: YYYY-MM-DD


Value: Must be a Date
tenant[military_information][military_id]
optional
Value: Must be a String
tenant[military_information][end_of_active_service_date]
optional

End date of active service, Format: YYYY-MM-DD


Value: Must be a Date
tenant[military_information][place_of_birth]
optional
Value: Must be a String
tenant[military_information][last_4_of_ssn]
optional

Must be a 4 digit number


Value: Must be a String
tenant[military_information][military_email_address]
optional

Must be a valid email address


Value: Must be a String
tenant[military_information][military_rank]
optional
Value: Must be a String
tenant[military_information][current_duty_location]
optional
Value: Must be a String
tenant[military_information][branch_of_service]
optional

Must be Air Force, Army, Coast Guard, Marines, Navy, National Guard, or Other


Value: Must be a String
tenant[military_information][military_unit]
optional
Value: Must be a String
tenant[military_information][squadron]
optional
Value: Must be a String
tenant[military_information][division]
optional
Value: Must be a String
tenant[military_information][type_of_service]
optional

Must be Active Component or Veteran


Value: Must be a String
tenant[military_information][agent_first_name]
optional
Value: Must be a String
tenant[military_information][agent_last_name]
optional
Value: Must be a String
tenant[military_information][agent_email_address]
optional

Must be a valid email address


Value: Must be a String
tenant[military_information][agent_phone_number]
optional

Must be a valid phone number


Value: Must be a String
tenant[military_information][agent_address]
optional
Value: Must be a String
tenant[military_information][agent_city]
optional
Value: Must be a String
tenant[military_information][agent_state]
optional

Must be a valid state abbreviation


Value: Must be a String
tenant[military_information][agent_postal_code]
optional

Must be a valid US postal code


Value: Must be a String
tenant[military_information][officer_first_name]
optional
Value: Must be a String
tenant[military_information][officer_last_name]
optional
Value: Must be a String
tenant[military_information][officer_phone_number]
optional

Must be a valid phone number


Value: Must be a String
tenant[password_recovery_questions_attributes]
optional

Password recovery questions


Value: Must be an Array of nested elements
tenant[password_recovery_questions_attributes][question]
required
Value: Must be a String
tenant[password_recovery_questions_attributes][answer]
required
Value: Must be a String
tenant[phone_numbers_attributes]
required

A collection of phone numbers.


Value: Must be an Array of nested elements
tenant[phone_numbers_attributes][number]
optional

Phone number


Value: Must be a String
tenant[phone_numbers_attributes][extension]
required

Phone number extension


Value: Must be a String
tenant[phone_numbers_attributes][label]
optional

A label for what the phone number is, such as Home, Work, Mobile, etc.


Value: Must be a String
tenant[phone_numbers_attributes][primary]
optional

Flag that indicates if this is the primary phone number of the tenant


Value: Must be a String
tenant[phone_numbers_attributes][sms_opt_in]
optional

Opt the tenant in to SMS (if applicable). Requires a "Mobile" label for SMS to work correctly.


Value: Must be one of: <code>true</code>, <code>false</code>.
tenant[mailing_address_attributes]
required

A collection of addresses.


Value: Must be a Hash
tenant[mailing_address_attributes][address1]
required
Value: Must be a String
tenant[mailing_address_attributes][address2]
optional
Value: Must be a String
tenant[mailing_address_attributes][city]
required
Value: Must be a String
tenant[mailing_address_attributes][state]
required
Value: Must be a String
tenant[mailing_address_attributes][postal]
required
Value: Must be a String
tenant[contacts_attributes]
optional

A collection of contacts.


Value: Must be an Array of nested elements
tenant[contacts_attributes][first_name]
optional
Value: Must be a String
tenant[contacts_attributes][middle_initial]
optional
Value: Must be a String
tenant[contacts_attributes][last_name]
optional
Value: Must be a String
tenant[contacts_attributes][email]
optional
Value: Must be a String
tenant[contacts_attributes][description]
required

Contact description


Value: Must be a String
tenant[contacts_attributes][primary]
optional

Flag that indicates if this is the primary contact of the tenant


Value: Must be a String
tenant[contacts_attributes][phone_numbers_attributes]
optional

A collection of phone numbers.


Value: Must be an Array of nested elements
tenant[contacts_attributes][phone_numbers_attributes][number]
optional

Phone number


Value: Must be a String
tenant[contacts_attributes][phone_numbers_attributes][extension]
optional

Phone number extension


Value: Must be a String
tenant[contacts_attributes][phone_numbers_attributes][label]
optional

A label for what the phone number is, such as Home, Work, Mobile, etc.


Value: Must be a String
tenant[contacts_attributes][phone_numbers_attributes][primary]
optional

Flag that specifies if this is the primary phone number of the contact


Value: Must be a String
tenant[contacts_attributes][address_attributes]
optional

A collection of addresses.


Value: Must be a Hash
tenant[contacts_attributes][address_attributes][address1]
optional
Value: Must be a String
tenant[contacts_attributes][address_attributes][address2]
optional
Value: Must be a String
tenant[contacts_attributes][address_attributes][city]
optional
Value: Must be a String
tenant[contacts_attributes][address_attributes][state]
optional
Value: Must be a String
tenant[contacts_attributes][address_attributes][postal]
optional
Value: Must be a String