fynk API

fynk API

The fynk API enables developers to seamlessly integrate powerful contract management capabilities into their existing systems. Generate, update, and manage contracts programmatically with a secure and scalable REST API designed for modern businesses.

Whether you're automating contract creation, syncing data between systems, or building custom workflows, the fynk API provides the flexibility and reliability you need to streamline your contract lifecycle management.

Key Features:

1. Automated Contract Generation - Create contracts programmatically from templates with dynamic data
2. Seamless System Integration - Connect fynk with your CRM, ERP, or custom applications
3. Version Control & Tracking - Maintain complete audit trails and version history
4. Real-time Contract Updates - Synchronize contract data across all your systems instantly
5. Secure & Scalable Architecture - Enterprise-grade security with OAuth 2.0 and API token authentication

Authentication

The fynk API uses API token authentication via HTTP Authorization header:

// JavaScript Example
const axios = require('axios');

const fynkApi = axios.create({
  baseURL: 'https://api.fynk.com/v1',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

// Create a new contract from template
async function createContract() {
  try {
    const response = await fynkApi.post('/contracts', {
      templateId: 'template_123',
      variables: {
        clientName: 'Acme Corp',
        contractValue: '50000',
        startDate: '2025-01-01'
      }
    });
    
    console.log('Contract created:', response.data);
    return response.data;
  } catch (error) {
    console.error('Error creating contract:', error.response?.data);
  }
}

// Get contract details
async function getContract(contractId) {
  try {
    const response = await fynkApi.get(`/contracts/${contractId}`);
    console.log('Contract details:', response.data);
    return response.data;
  } catch (error) {
    console.error('Error fetching contract:', error.response?.data);
  }
}

// Update contract status
async function updateContract(contractId, status) {
  try {
    const response = await fynkApi.patch(`/contracts/${contractId}`, {
      status: status
    });
    console.log('Contract updated:', response.data);
    return response.data;
  } catch (error) {
    console.error('Error updating contract:', error.response?.data);
  }
}

createContract();

Python Example

import requests

class FynkAPI:
    def __init__(self, api_token):
        self.base_url = 'https://api.fynk.com/v1'
        self.headers = {
            'Authorization': f'Bearer {api_token}',
            'Content-Type': 'application/json'
        }
    
    def create_contract(self, template_id, variables):
        """Create a new contract from template"""
        url = f'{self.base_url}/contracts'
        data = {
            'templateId': template_id,
            'variables': variables
        }
        
        response = requests.post(url, json=data, headers=self.headers)
        response.raise_for_status()
        return response.json()
    
    def get_contract(self, contract_id):
        """Retrieve contract details"""
        url = f'{self.base_url}/contracts/{contract_id}'
        response = requests.get(url, headers=self.headers)
        response.raise_for_status()
        return response.json()
    
    def update_contract(self, contract_id, status):
        """Update contract status"""
        url = f'{self.base_url}/contracts/{contract_id}'
        data = {'status': status}
        
        response = requests.patch(url, json=data, headers=self.headers)
        response.raise_for_status()
        return response.json()

# Usage
api = FynkAPI('YOUR_API_TOKEN')

# Create a contract
contract = api.create_contract('template_123', {
    'clientName': 'Acme Corp',
    'contractValue': '50000',
    'startDate': '2025-01-01'
})

print('Contract created:', contract)

cURL Example

# Create a new contract
curl -X POST 'https://api.fynk.com/v1/contracts' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "templateId": "template_123",
    "variables": {
      "clientName": "Acme Corp",
      "contractValue": "50000",
      "startDate": "2025-01-01"
    }
  }'

# Get contract details
curl -X GET 'https://api.fynk.com/v1/contracts/CONTRACT_ID' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

# Update contract status
curl -X PATCH 'https://api.fynk.com/v1/contracts/CONTRACT_ID' \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"status": "signed"}'

🔗 Explore the full API documentation