Applicant Groups

Create a new applicant group

post
/api/v1/applicant_groups

Creates a new applicant group to send applicants their corresponding verifications. When an applicant group is created successfully, an email and/or text is sent to all applicants inviting them to complete their verifications unless the invitation is disabled.

Authorizations
AuthorizationstringRequired

JWT token obtained from the /api/v1/tenants/auth endpoint. Token expires after 30 minutes and must be refreshed.

Example: Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...

Body
decision_maker_display_namestringRequired

Display name for the decision maker

Example: ABC Property Management
monthly_rentnumber · integerRequired

Monthly rent amount in cents

Example: 250000
webhook_urlstringOptional

The URL that will receive webhook notifications for the applicant group created.

Example: https://www.yourwebsite.com/webhook
is_invitation_disabledbooleanOptional

If you decide to not want Payscore to invite the applicant via email and/or text, pass in true for this field. If you are utilizing our embedded widget, you will want to pass in true to this field.

correlation_idstringOptional

External system correlation identifier

Example: PROP-123-UNIT-456
Responses
200

Applicant group created successfully

application/json
post
/api/v1/applicant_groups
POST /api/v1/applicant_groups HTTP/1.1
Host: api.payscore.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 501

{
  "applicants": [
    {
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "[email protected]",
      "phone_number": "+19842342345",
      "verifications": [
        {
          "type": "asset_verification"
        }
      ]
    }
  ],
  "property": {
    "name": "ABC Apartments",
    "street_address": "123 Main Street",
    "city": "San Francisco",
    "state": "CA",
    "zip_code": "94102",
    "unit": "2A"
  },
  "decision_maker_display_name": "ABC Property Management",
  "monthly_rent": 250000,
  "webhook_url": "https://www.yourwebsite.com/webhook",
  "is_invitation_disabled": true,
  "correlation_id": "PROP-123-UNIT-456"
}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "decision_maker_display_name": "ABC Property Management",
  "property": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "ABC Apartments",
    "street_address": "123 Main Street",
    "city": "San Francisco",
    "state": "CA",
    "zip_code": "94102"
  },
  "status": "pending",
  "created_at_timestamp": 1640995200.123,
  "monthly_rent_cents": 250000,
  "unit_number": "2A",
  "is_free": false,
  "is_decision_maker_paying": true,
  "applicants": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "[email protected]",
      "phone_number": "+19842342345",
      "created_at": "2024-01-01T12:00:00Z",
      "updated_at": "2024-01-01T12:00:00Z",
      "verifications": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "type": "asset_verification",
          "status": "pending"
        }
      ]
    }
  ]
}
PreviousAuthenticationNextReports

Last updated