remofirst-install-auth

RemoFirst Install Auth

Overview

Set up RemoFirst API authentication for global HR and payroll integration. RemoFirst provides API access for enterprise customers.

Prerequisites

• RemoFirst enterprise account
• API credentials from RemoFirst support team
• Node.js 18+ or Python 3.9+

Instructions

Step 1: Get API Credentials

1. Contact RemoFirst support for API access
2. Receive API key and base URL
3. Note: Sandbox environment available for testing

Step 2: Configure Environment

# .env
REMOFIRST_API_KEY=your_api_key
REMOFIRST_BASE_URL=https://api.remofirst.com/v1

Step 3: Initialize Client

import os, requests

class RemoFirstClient:
    def __init__(self):
        self.base_url = os.environ["REMOFIRST_BASE_URL"]
        self.headers = {
            "Authorization": f"Bearer {os.environ['REMOFIRST_API_KEY']}",
            "Content-Type": "application/json",
        }

    def get(self, path, params=None):
        resp = requests.get(f"{self.base_url}{path}", headers=self.headers, params=params)
        resp.raise_for_status()
        return resp.json()

    def post(self, path, data):
        resp = requests.post(f"{self.base_url}{path}", headers=self.headers, json=data)
        resp.raise_for_status()
        return resp.json()

client = RemoFirstClient()

Step 4: Verify Connection

company = client.get("/company")
print(f"Connected! Company: {company['name']}")
print(f"Countries: {len(company.get('active_countries', []))}")

Output

• API credentials configured
• Client initialized with authentication
• Connection verified

Error Handling

Error	Cause	Solution
401 Unauthorized	Invalid API key	Contact RemoFirst support
403 Forbidden	API access not enabled	Request API access from account manager
Connection refused	Wrong base URL	Verify URL with RemoFirst

Resources

• RemoFirst
• Global HR Solutions

Next Steps

First API call: remofirst-hello-world