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

# Create Record Deals



## OpenAPI

````yaml /actionkit/openapi.json POST /projects/{project_id}/tools/#PIPEDRIVE_CREATE_RECORD_DEALS_V2
openapi: 3.0.0
info:
  title: ActionKit Tools API
  version: 1.0.0
servers:
  - url: https://actionkit.useparagon.com
    description: US Cloud
security: []
paths:
  /projects/{project_id}/tools/#PIPEDRIVE_CREATE_RECORD_DEALS_V2:
    post:
      summary: Create Record Deals
      parameters:
        - name: project_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              Your Paragon Project ID. You can copy your Project ID from your
              dashboard URL or by clicking Copy Project ID under the Environment
              switcher.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                tool:
                  type: string
                  default: PIPEDRIVE_CREATE_RECORD_DEALS_V2
                parameters:
                  type: object
                  properties:
                    title:
                      type: string
                      description: Title
                    value:
                      type: string
                      description: Value
                    status:
                      type: string
                      description: 'Status : Defaults to Open if left blank.'
                      enum:
                        - open
                        - won
                        - lost
                        - deleted
                    expectedCloseDate:
                      type: string
                      description: >-
                        Expected Close Date : Accepts Unix timestamp or ISO8601
                        date formats.
                    ownerId:
                      type: string
                      description: >-
                        Owner ID : The ID of the user who the deal will be
                        assigned to. Defaults to the currently authenticated
                        user if left blank.
                    personId:
                      type: string
                      description: >-
                        Person ID : The ID of the person who the deal will be
                        assigned to.
                    organizationId:
                      type: string
                      description: >-
                        Organization ID : The ID of an organization which this
                        deal will be linked to.
                    pipelineId:
                      type: string
                      description: >-
                        Pipeline ID : Use Connect Portal Workflow Settings to
                        allow users to select which pipeline the deal will be
                        added to. By default, the deal will be added to the
                        first stage of the specified pipeline.
                    stageId:
                      type: string
                      description: >-
                        Stage ID : Use Connect Portal Workflow Settings to allow
                        users to select which stage the deal will be added to. A
                        pipeline will be assigned automatically based on the
                        Stage ID. If left blank, the deal will be placed in the
                        first stage of the default pipeline.
                    additionalFields:
                      type: object
                      description: >-
                        Additional Fields : Specify any other fields that should
                        be updated in JSON below. Use Connect Portal Workflow
                        Settings to allow users to select which deal fields to
                        update. (example: "{

                        "property_number": "17",

                        "property_dropdown": "choice_b",

                        "property_radio": "option_1",

                        "property_string": "value",

                        "property_date": "1572480000000"

                        }")
                      properties: {}
                  required:
                    - title
                  x-integration: pipedrive
              required:
                - tool
                - parameters
      responses:
        '200':
          description: Success
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Your [Paragon User
        Token](/getting-started/installing-the-connect-sdk#setup) (JWT), which
        you can generate using your project's signing keys.

````