​

HTTP Custom Auth Credentials

​

Overview

• Multi-part authentication schemes
• Custom header, query, and body combinations
• APIs with non-standard authentication requirements
• Flexible authentication definitions in JSON
• Advanced integration scenarios

​

Dashboard Screenshot

​

Steps to Create HTTP Custom Auth Credentials

​

1. Identify Custom Auth Requirements

• Look for header, query, and body parameters
• Check the exact field names and values
• Verify whether values need to be nested
• Note any required prefixes or formatting

​

2. Build the Authentication JSON

{
  "headers": {
    "X-API-Key": "your-api-key"
  },
  "body": {
    "token": "your-token"
  },
  "qs": {
    "api_key": "your-query-key"
  }
}

• headers: Custom HTTP headers to include
• body: Fields to add to the request body
• qs: Query string parameters to append to the URL

​

3. Add to SubverseAI

1. Go to Credentials in your SubverseAI dashboard
2. Click Create New Credential
3. Select HTTP Custom Auth from the credential types
4. Enter a name for your credential
5. Fill in the required field:
   • JSON: The authentication JSON definition
6. Click Save Credential

​

Required Fields

• Name: A descriptive name for your credential
• JSON: A JSON object defining authentication values for headers, body, and query string

​

Usage Tips

• Use HTTPS endpoints to protect credentials in transit
• Validate your JSON format before saving
• Store sensitive values securely and rotate them regularly
• Test authentication against the target API endpoint

​

Troubleshooting

​

Next Steps

• Build advanced multi-part authentication workflows
• Integrate with non-standard APIs
• Test authentication across different request types
• Monitor authentication success and failure rates