Postman Collection

Test and explore Samva APIs using our official Postman collection.

Import Collection

Option 1: Import from URL

1. Open Postman
2. Click Import in the top left
3. Select the Link tab
4. Enter: https://api.samva.app/v1/openapi.json
5. Click Continue and then Import

Option 2: Import from OpenAPI Spec

1. Visit api.samva.app/v1/openapi.json
2. Save the file locally
3. In Postman, click Import → Upload Files
4. Select the saved JSON file

Configure Authentication

After importing, set up your API key:

1. Click on the collection name in the sidebar
2. Go to the Variables tab
3. Add a variable named apiKey
4. Set the value to your API key (e.g., sk_live_your_api_key)
5. Click Save

Then update the collection's authorization:

1. Go to the Authorization tab
2. Select API Key as the type
3. Set Key to X-API-Key
4. Set Value to {{apiKey}}
5. Set Add to to Header

Collection Features

• All API endpoints - Complete coverage of Samva API
• Pre-configured examples - Ready-to-use request bodies
• Environment variables - Easy switching between environments
• Response examples - Sample responses for each endpoint

Environment Setup

Create environments for different stages:

Production

{
  "baseUrl": "https://api.samva.app/v1",
  "apiKey": "sk_live_your_production_key"
}

Development

{
  "baseUrl": "https://api.samva.app/v1",
  "apiKey": "sk_test_your_test_key"
}

Quick Test

After setup, try sending a test request:

1. Expand Email → Send Email
2. Click Send
3. Check the response

Next Steps