POST /admin/communication/providers

Create a connection configuration for an SMS/email/push provider for the current tenant. Supports major providers such as Alibaba Cloud, Tencent Cloud, AWS SNS/SES, SendGrid, FCM, etc. Configuration content (API keys, etc.) is stored encrypted and automatically masked in responses. References: ePrivacy Directive 2002/58/EC, CAN-SPAM Act.

Request Body

Schema: dto.CreateProviderConfigRequest

Field	Type	Required	Example	Constraints	Description
channel	string	Yes	sms	enum: `sms`, `email`, `push`
config	string	Yes	{"access_key":"..."}
provider	string	Yes	aliyun
priority	integer	No	10

Responses

Status	Description	Schema
201	Created successfully, returns configuration details (credentials masked)	dto.ProviderConfigDataResponse
400	Invalid request parameters	dto.SimpleResponse
401	Unauthenticated or invalid token	dto.SimpleResponse
403	Insufficient permissions to access this resource	dto.SimpleResponse
409	A configuration for the same channel and provider already exists	dto.SimpleResponse
500	Internal server error	dto.SimpleResponse

Referenced Schemas

dto.ProviderConfigDataResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
data	dto.ProviderConfigResponse	No
message	string	No
timestamp	string	No

dto.ProviderConfigResponse

Field	Type	Required	Example	Constraints	Description
app_id	string	No
channel	string	No
config	string	No
created_at	string	No
id	string	No
is_active	boolean	No
priority	integer	No
provider	string	No
tenant_id	string	No
updated_at	string	No

dto.SimpleResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
message	string	No
timestamp	string	No