Configure Service Provider
PUT/profile/:id/service
Configure external service providers for your profile. This allows you to set up integrations with third-party services for SMS and Email messaging.
Available service providers:
| Service Type | Provider | Description |
|---|---|---|
sms | Twilio | Send SMS messages via Twilio |
sms | SNS | Send SMS messages via Amazon SNS |
email | SendGrid | Send emails via SendGrid API |
email | SES | Send emails via Amazon SES |
email | SMTP | Send emails via custom SMTP server |
Important notes:
- Credentials are securely stored using TagoIO Secrets. You must create the appropriate secrets before configuring a service provider.
- Each service type can only have one active provider configuration at a time
- Use the test endpoint to verify your configuration before using it in production
Required secrets by provider:
- Twilio SMS: Create two Text secrets containing your Twilio SID and Auth Token
- SNS SMS: Create an AWS SQS Secret with your AWS credentials (region, access key, secret key)
- SendGrid Email: Create a Text secret containing your SendGrid API Key
- SES Email: Create an AWS SQS Secret with your AWS credentials (region, access key, secret key)
- SMTP Email: Create an SMTP Secret with your server configuration
Request
Responses
- 200
- 400
- 401
- 403
Service provider configured successfully
Bad request - Invalid configuration
Unauthorized - Invalid or missing token
Forbidden - Insufficient permissions