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

Next Steps

First API call: remofirst-hello-world