Connects a NEW channel to this Application in one step — mints the doorway and claims its address.
The app-owned-channels creation path — a channel is born inside an Application, never in an unbound state. Mints the inbound doorway (a MANUAL inbound channel binding, or the agent's messaging endpoint for endpoint-owned providers such as Telegram, whose config is both credential and address) and materializes its messaging entry point here. The agent must already be a member of this Application. Rejects (409) an address already in use by another Application — re-home a claimed address with `:move` instead. Returns the one-time webhook URL when a new channel binding was minted.
Authorization
Bearer JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.
In: header
Path Parameters
The target Network id.
uuidThe tenant identifier
The integration config, channel address parameters, and target member agent.
The tenant integration config carrying the channel (the connection's credentials).
uuidThe member agent the channel routes to. It must already be a member of this Network.
Operator-facing channel name; defaults to the config's display name.
Provider-specific address parameters selecting the channel on the connection (Slack channel id, phone number, …). Ignored for endpoint-owned providers, whose config IS the address (a Telegram bot token).
Endpoint-owned providers only: when the agent already fronts a different config's bot for this provider (one active bot per agent per provider), deactivate that bot and connect this one in its place. Without it such a connect is rejected 409 so a bot swap is always an explicit choice. The displaced bot keeps its endpoint record (reactivatable later); its doorway rows are removed.
Response Body
curl -X POST "https://api.fruxon.com/v1/tenants/string/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/entryPoints/connect" \ -H "Content-Type: application/json" \ -d '{}'{
"entryPoint": {
"id": "00000000-0000-0000-0000-000000000000",
"networkId": "00000000-0000-0000-0000-000000000000",
"networkIntegrationBindingId": "00000000-0000-0000-0000-000000000000",
"kind": "MESSAGING",
"provider": "string",
"externalAddress": "string",
"displayName": "string",
"integrationConfigId": "00000000-0000-0000-0000-000000000000",
"integrationConfigName": "string",
"agentMembershipId": "00000000-0000-0000-0000-000000000000",
"routingPolicyKey": "string",
"sourceKind": "CHANNEL_BINDING",
"sourceId": "00000000-0000-0000-0000-000000000000",
"operationalStatus": "ACTIVE",
"createdAt": 0,
"modifiedAt": 0
},
"webhookUrl": "string",
"replacedMessagingEndpointId": "00000000-0000-0000-0000-000000000000"
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}Attaches an inbound doorway to this Network so its real inbound routes here.
Materializes (or adopts off another Network) the doorway's messaging entry point on this Application, so a live inbound resolves this Application's deployment instead of the Default Network. Provide exactly one of `channelBindingId` (a per-participant channel binding) or `messagingEndpointId` (a per-agent provider endpoint — its Telegram bot, WhatsApp number, …). The doorway's agent must already be a member of this Network. Rejects (409) if the endpoint is already routed by a different source.
Detaches a messaging entry point from this Application, returning it to the Default Network.
The mirror of `attach`: re-points the doorway's messaging entry point back onto the tenant's Default Network so a live inbound falls back to Default-Network behaviour, while preserving the entry point's stable provider/address identity and backing source. The route's agent membership is re-resolved on the Default Network. Rejects (400) an entry point that is already on the Default Network.