Skip to main content


Returns the agent’s unique URL




String — the agent’s full URL


Each agent is accessed remotely through a unique URL, generated when a specific agent’s device is authorized to access the Electric Imp impCloud™. This method informs the agent of its own URL. As such, it provides a way for an agent to pass its URL on to a third-party website or a mobile app, or to add it into an agent-served user interface — as shown in this sample code.

See the documentation for the http object method http.onrequest() to learn how an agent can handle HTTP requests made to this URL.