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

# /workflows/firm-member-realtor-find-or-create

> Finds or creates a RealtorProfile and FirmMember for the given email address and firm ID.



## OpenAPI

````yaml https://perch-api-docs.s3.ca-central-1.amazonaws.com/perch-partner.spec.json post /workflows/firm-member-realtor-find-or-create
openapi: 3.1.0
info:
  title: Perch Partner Web API
  version: v1
  contact:
    name: API Support
    url: https://myperch.io
    email: support@myperch.io
  description: This is the API used by the Perch Partner portal.
servers:
  - description: DIT
    url: https://api.partner.dit.myperch.io/v1
  - description: Production
    url: https://api.partner.myperch.io/v1
security:
  - x-api-key: []
tags:
  - name: 'Workflows: Firm Member'
    description: 'Operations involving Workflows: Firm Member'
  - name: Lead
    description: Operations involving Lead
  - name: Plan
    description: Operations involving Plan
paths:
  /workflows/firm-member-realtor-find-or-create:
    post:
      tags:
        - 'Workflows: Firm Member'
      summary: /workflows/firm-member-realtor-find-or-create
      description: >-
        Finds or creates a RealtorProfile and FirmMember for the given email
        address and firm ID.
      operationId: workflow-firm-member-realtor-find-or-create
      requestBody:
        description: The parameters required to run the Realtor Find Or Create workflow.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FirmMemberRealtorFindOrCreateParameters'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      firmMemberId:
                        type: string
                        description: The ID of the realtor
                      email:
                        type: string
                        description: The email address of the realtor
        '422':
          description: Must be a realty firm
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      fields:
                        type: object
                        description: >-
                          A map of field names to a list error messages (e.g. {
                          "email": ["Email is already taken."] })
                        example:
                          email:
                            - Invalid format for email address
                          password:
                            - Password must be at least 8 characters long
components:
  schemas:
    FirmMemberRealtorFindOrCreateParameters:
      type: object
      properties:
        firmId:
          type: string
          description: The ID of the Firm to which the realtor belongs
        email:
          type: string
          description: The email address of the realtor
          format: email
        firstName:
          type: string
          description: The first name of the realtor
        lastName:
          type: string
          description: The last name of the realtor
      required:
        - email
        - firstName
        - lastName
  securitySchemes:
    x-api-key:
      name: x-api-key
      type: apiKey
      in: header

````