> ## Documentation Index > Fetch the complete documentation index at: https://apidocs.noyax.com/llms.txt > Use this file to discover all available pages before exploring further. # Yetkili oluştur > Cariye yeni yetkili ekler. `FullName` zorunludur. `Email` gönderilirse geçerli bir e-posta adresi olmalıdır. ## OpenAPI ````yaml api-reference/openapi.tr.json POST /api/v1/customers/{customerId}/representatives openapi: 3.1.1 info: title: Noyax API description: Server-to-server API for integrations to access Noyax data. version: '1.0' servers: - url: https://api.noyax.com security: - Bearer: [] tags: - name: Sections - name: Warehouses - name: Product Critical Stock - name: Product groups - name: Product Parameter Definitions - name: Product Parameters - name: Product Prices - name: Products - name: Cities - name: Countries - name: Currencies - name: Districts - name: Shipment Definitions - name: Units - name: VAT rates - name: Customer Addresses - name: Customer Bank Accounts - name: Customer Definitions - name: Customer Group Members - name: Customer Links - name: Customer Parameters - name: Customer Representatives - name: Customers - name: Customer Statement - name: Customer Telephones paths: /api/v1/customers/{customerId}/representatives: post: tags: - Customer Representatives summary: Yetkili oluştur description: Cariye yeni yetkili ekler. parameters: - name: customerId in: path description: Cari ID'si. required: true schema: type: string format: uuid - name: X-UserID in: header description: >- İsteğin adına yapıldığı Noyax kullanıcısının ID'si. Oluşturulan, güncellenen ve silinen kayıtların denetim alanlarına yazılır. required: true schema: minimum: 1 type: integer format: int32 - name: X-CompanyID in: header description: >- Şirketin ID'si. Kullanıcı bu şirkete tanımlı olmalıdır. Bütün okuma ve yazma işlemleri bu şirketle sınırlıdır. required: true schema: minimum: 1 type: integer format: int32 - name: X-PeriodID in: header description: >- Muhasebe döneminin ID'si. Cari endpoint'lerinde isteğe bağlıdır; gönderilirse oluşturulan kayıtlara yazılır. schema: minimum: 1 type: integer format: int32 requestBody: content: application/json: schema: $ref: '#/components/schemas/CustomerRepresentativeRequestDto' text/json: schema: $ref: '#/components/schemas/CustomerRepresentativeRequestDto' application/*+json: schema: $ref: '#/components/schemas/CustomerRepresentativeRequestDto' required: true responses: '201': description: Created content: application/json: schema: $ref: '#/components/schemas/DataResultOfCustomerRepresentativeDto' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorResult' example: Success: false ResultCode: '1401' Message: Representative FullName is required. Errors: - Code: '1401' Message: Representative FullName is required. '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResult' example: Success: false ResultCode: '0102' Message: Token has expired. Obtain a new token using the refresh token. Errors: - Code: '0102' Message: >- Token has expired. Obtain a new token using the refresh token. '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResult' example: Success: false ResultCode: '0110' Message: You do not have permission for this operation. Errors: - Code: '0110' Message: You do not have permission for this operation. '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorResult' example: Success: false ResultCode: '1000' Message: Customer not found. Errors: - Code: '1000' Message: Customer not found. '429': description: Too Many Requests content: application/json: schema: $ref: '#/components/schemas/ErrorResult' example: Success: false ResultCode: '0120' Message: Daily request limit (10000) exceeded. Errors: - Code: '0120' Message: Daily request limit (10000) exceeded. components: schemas: CustomerRepresentativeRequestDto: type: object properties: FullName: type: - 'null' - string description: Zorunlu. Yetkili kişinin adı soyadı. example: Ayşe Yılmaz Position: type: - 'null' - string description: Görevi ya da pozisyonu. example: Purchasing Manager Gsm: type: - 'null' - string description: Cep telefonu numarası. example: '05325550000' Email: type: - 'null' - string description: E-posta adresi. Gönderilirse geçerli olmalıdır. example: ayse.yilmaz@example.com Phone: type: - 'null' - string description: Sabit telefon numarası. example: '02165550000' Extension: type: - 'null' - string description: Dahili numara. example: '105' Link: type: - 'null' - string description: Link, ör. LinkedIn profili. example: https://www.linkedin.com/in/example Description: type: - 'null' - string description: Açıklama. DataResultOfCustomerRepresentativeDto: required: - Success - ResultCode - Data type: object properties: Success: type: boolean description: İşlemin başarılı olup olmadığı. example: true ResultCode: type: string description: >- Başarıda "0000". Hatada ilk hatanın kodu; hataların tamamı Errors içinde listelenir. example: '0000' Message: type: - 'null' - string description: >- Success false olduğunda hata mesajı. Bütün hataların mesajları tek metinde birleştirilir. Data: $ref: '#/components/schemas/CustomerRepresentativeDto' ErrorResult: type: object properties: Success: type: boolean description: İşlemin başarılı olup olmadığı. example: false ResultCode: type: - 'null' - string description: >- Başarıda "0000". Hatada ilk hatanın kodu; hataların tamamı Errors içinde listelenir. Message: type: - 'null' - string description: >- Success false olduğunda hata mesajı. Bütün hataların mesajları tek metinde birleştirilir. Errors: type: - 'null' - array items: $ref: '#/components/schemas/ResultError' description: >- Kodlarıyla birlikte bütün hatalar. Yalnızca Success false olduğunda bulunur. CustomerRepresentativeDto: type: object properties: Id: type: string description: Yetkili ID'si. format: uuid CustomerId: type: string description: Cari ID'si. format: uuid FullName: type: - 'null' - string description: Zorunlu. Yetkili kişinin adı soyadı. example: Ayşe Yılmaz Position: type: - 'null' - string description: Görevi ya da pozisyonu. example: Purchasing Manager Gsm: type: - 'null' - string description: Cep telefonu numarası. example: '05325550000' Email: type: - 'null' - string description: E-posta adresi. Gönderilirse geçerli olmalıdır. example: ayse.yilmaz@example.com Phone: type: - 'null' - string description: Sabit telefon numarası. example: '02165550000' Extension: type: - 'null' - string description: Dahili numara. example: '105' Link: type: - 'null' - string description: Link, ör. LinkedIn profili. example: https://www.linkedin.com/in/example Description: type: - 'null' - string description: Açıklama. ResultError: required: - Code - Message type: object properties: Code: type: string description: Hata kodu. Tam liste için sonuç kodları sayfasına bakın. Message: type: string description: Hata açıklaması. securitySchemes: Bearer: type: http description: Access token obtained from the Noyax auth service with your API key. scheme: bearer bearerFormat: JWT ````