# Create Partner

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /partners:
    post:
      summary: Create Partner
      deprecated: false
      description: ''
      operationId: PostPartnerList
      tags:
        - API Reference/Partners
        - Partners
      parameters: []
      requestBody:
        content:
          application/json:
            schema: &ref_0
              $ref: '#/components/schemas/Partner'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                type: object
                properties:
                  data: *ref_0
                required:
                  - data
                x-apidog-orders:
                  - data
                x--orders:
                  - data
                x--ignore-properties: []
          headers: {}
          x-apidog-name: ''
      security: []
      x-apidog-folder: API Reference/Partners
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1200447/apis/api-38447144-run
components:
  schemas:
    Partner:
      type: object
      properties:
        id:
          type: string
          title: ''
          description: Unique identifier in the Makini dataset.
          readOnly: true
          examples:
            - 12345678aaaaaa111111bbbbbb222222cccccc33
        code:
          type: string
          title: ''
          description: A unique identifier code for this entity.
          examples:
            - entity-code-1
        _source:
          type: string
          title: ''
          description: >-
            The originating source table/endpoint or derivation name for this
            record.
          readOnly: true
          examples:
            - EndpointName
            - TableName
            - derived
        _idValue:
          type: string
          title: ''
          description: The original identifier value from the source system.
          readOnly: true
          examples:
            - '1234'
            - '000000001'
            - ABCID123
        _displayValue:
          type: string
          description: A human-readable display label derived from the source record.
          readOnly: true
          title: ''
        _updatedAt:
          type: string
          description: >-
            Timestamp indicating when this record was last updated in the source
            system.
          readOnly: true
          format: date-time
        _createdAt:
          type: string
          description: >-
            Timestamp indicating when this record was created in the source
            system.
          format: date-time
          readOnly: true
        _deletedAt:
          type: string
          description: >-
            Timestamp indicating when this record was deleted/soft-deleted in
            the source system; null if not deleted.
          format: date-time
          readOnly: true
          nullable: true
        _implements:
          type: array
          description: A list of interface/schema identifiers that this record implements.
          items:
            type: string
          readOnly: true
        name:
          type: string
          description: The name of the entity.
          examples:
            - Entity Name
        description:
          type: string
          description: An optional description providing more details about the entity.
          examples:
            - Entity Description
          nullable: true
        legalName:
          type: string
          description: Official registered legal name of the partner entity
          nullable: true
        currency:
          anyOf:
            - $ref: '#/components/schemas/Relation'
            - $ref: '#/components/schemas/Currency'
            - type: 'null'
          description: >-
            Currency associated with the partner entity/relationship; may
            reference a currency definition or be null
        isActive:
          type: boolean
          description: Flag indicating if the partnership is currently active
        partnerSinceDate:
          type: string
          format: date
          description: Date when the partnership began
          nullable: true
        partnerEndDate:
          type: string
          format: date
          description: Date when the partnership ended or is scheduled to end
          nullable: true
      required:
        - id
        - code
        - _source
        - _idValue
        - _displayValue
        - _updatedAt
        - _createdAt
        - _deletedAt
        - _implements
        - name
      x-apidog-orders:
        - id
        - code
        - _source
        - _idValue
        - _displayValue
        - _updatedAt
        - _createdAt
        - _deletedAt
        - _implements
        - name
        - description
        - legalName
        - currency
        - isActive
        - partnerSinceDate
        - partnerEndDate
      x--orders:
        - id
        - code
        - _source
        - _idValue
        - _displayValue
        - _updatedAt
        - _createdAt
        - _deletedAt
        - _implements
        - name
        - description
        - legalName
        - currency
        - isActive
        - partnerSinceDate
        - partnerEndDate
      x--ignore-properties: []
      x-apidog-folder: ''
    Currency:
      type: object
      properties:
        id:
          type: string
          title: ''
          description: Unique identifier in the Makini dataset.
          readOnly: true
          examples:
            - 12345678aaaaaa111111bbbbbb222222cccccc33
        code:
          type: string
          title: ''
          description: A unique identifier code for this entity.
          examples:
            - entity-code-1
        _source:
          type: string
          title: ''
          description: >-
            The originating source table/endpoint or derivation name for this
            record.
          readOnly: true
          examples:
            - EndpointName
            - TableName
            - derived
        _idValue:
          type: string
          title: ''
          description: The original identifier value from the source system.
          readOnly: true
          examples:
            - '1234'
            - '000000001'
            - ABCID123
        _displayValue:
          type: string
          description: A human-readable display label derived from the source record.
          readOnly: true
          title: ''
        _updatedAt:
          type: string
          description: >-
            Timestamp indicating when this record was last updated in the source
            system.
          readOnly: true
          format: date-time
        _createdAt:
          type: string
          description: >-
            Timestamp indicating when this record was created in the source
            system.
          format: date-time
          readOnly: true
        _deletedAt:
          type: string
          description: >-
            Timestamp indicating when this record was deleted/soft-deleted in
            the source system; null if not deleted.
          format: date-time
          readOnly: true
          nullable: true
        _implements:
          type: array
          description: A list of interface/schema identifiers that this record implements.
          items:
            type: string
          readOnly: true
        name:
          type: string
          description: The name of the entity.
          examples:
            - Entity Name
        description:
          type: string
          description: An optional description providing more details about the entity.
          examples:
            - Entity Description
          nullable: true
        symbol:
          type: string
        decimalPlaces:
          type: integer
          default: 2
        isActive:
          type: boolean
      required:
        - id
        - code
        - _source
        - _idValue
        - _displayValue
        - _updatedAt
        - _createdAt
        - _deletedAt
        - _implements
        - name
        - isActive
      x-apidog-orders:
        - id
        - code
        - _source
        - _idValue
        - _displayValue
        - _updatedAt
        - _createdAt
        - _deletedAt
        - _implements
        - name
        - description
        - symbol
        - decimalPlaces
        - isActive
      x--orders:
        - id
        - code
        - _source
        - _idValue
        - _displayValue
        - _updatedAt
        - _createdAt
        - _deletedAt
        - _implements
        - name
        - description
        - symbol
        - decimalPlaces
        - isActive
      x--ignore-properties: []
      x-apidog-folder: ''
    Relation:
      type: object
      properties:
        id:
          type: string
          description: Related entity Makini ID
          examples:
            - 12345678aaaaaa111111bbbbbb222222cccccc33
        _idValue:
          type: string
          examples:
            - '1234'
            - '000000001'
            - ABCID123
          description: Related entity source ID
        _displayValue:
          type: string
          description: Human-readable description
        rel:
          type: string
          readOnly: true
          examples:
            - endpoint
          description: Related endpoint
        href:
          type: string
          format: uri
          readOnly: true
          examples:
            - >-
              https://api.makini.io/v4/endpoints/12345678aaaaaa111111bbbbbb222222cccccc33
          description: Resource URI
      required:
        - id
        - _idValue
        - _displayValue
        - rel
        - href
      x-apidog-orders:
        - id
        - _idValue
        - _displayValue
        - rel
        - href
      x--orders:
        - id
        - _idValue
        - _displayValue
        - rel
        - href
      x--ignore-properties: []
      x-apidog-folder: ''
  securitySchemes:
    Connection Token:
      type: bearer
      scheme: bearer
    Account Credentials:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://
servers:
  - url: https://api.makini.io/v4
    description: Prod Env
security: []

```
