WOLFRAM

Wolfram Language & System Documentation Center

ServiceConnect["service"]

creates a connection to an external service.

ServiceConnect["service","id"]

uses the specified connection identifier.

Details and Options
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Options  
Authentication  
SaveConnection  
See Also
Related Guides
Related Links
History
Cite this Page

ServiceConnect   

Listing of Supported External Services »

ServiceConnect["service"]

creates a connection to an external service.

ServiceConnect["service","id"]

uses the specified connection identifier.

Details and Options

  • ServiceConnect works with a growing number of external services.
  • Use $Services to see all available services, also given in the guide "Listing of Supported External Services".
  • If it succeeds in making a connection, ServiceConnect returns a ServiceObject.
  • Use ServiceObjects[] to list all available service objects.
  • ServiceConnect["service"] will attempt to reopen the last used connection to a particular service if it exists; otherwise, it creates a new connection.
  • ServiceConnect["service","id"] attempts to restore connection with the specified ID. If the connection cannot be restored, a new connection will be created with the provided ID.
  • ServiceConnect["service","New"] forces a new connection to be created to a particular service.
  • The following options can be provided:
  • Authentication Automaticthe authentication credentials or method
    SaveConnection Falsewhether to store the connection in user's cloud account
  • Services are typically authenticated through API keys, username and passwords or OAuth authorization.
  • Possible settings for Authentication include:
  • Automaticattempt to use saved credentials or give a dialog
    "Dialog"give authentication parameters via a dialog
    Environment["var"]retrieve authentication from environment variables
    SystemCredential["key"]retrieve authentication information from secure storage
    SystemCredentialData[…]stored authentication data
    SecuredAuthenticationKey[…]give an OAuth-secured authentication key
    assocprovide explicit credentials
  • Use delayed settings such as Authentication:>SystemCredential["key"] to delay the evaluation of stored credentials.

Examples

open all close all

Basic Examples  (1)

Create a new connection to ArXiv:

Wolfram Language code: arxiv = ServiceConnect["ArXiv"]

Search articles about photoelectron spectroscopy:

Wolfram Language code: ServiceExecute[arxiv, "Search", {"Query" -> "photoelectron spectroscopy"}][All, "Title"]

Scope  (4)

Authenticate a Reddit account to retrieve information:

Wolfram Language code: reddit = ServiceConnect["Reddit"]

Retrieve information about the "r/space" subreddit:

Wolfram Language code: reddit["SubredditInformation", {"Subreddit" -> "Space"}]

Create a service object with a specified ID:

Wolfram Language code: so1 = ServiceConnect["OpenAI", "first", Authentication -> "auth1"] so2 = ServiceConnect["OpenAI", "second", Authentication -> "auth2"]

Verify the stored authentication information:

Wolfram Language code: so1["Authentication"] so2["Authentication"]

Retrieve a service object with a specific ID:

Wolfram Language code: ServiceConnect["OpenAI", "second"] %["Authentication"]

If multiple service objects for a service exist, ServiceConnect will pick the last used one:

Wolfram Language code: ServiceConnect["OpenAI", "first"]; ServiceConnect["OpenAI", "second"];

List all the existing service objects for OpenAI:

Wolfram Language code: ServiceObjects["OpenAI"]

Let ServiceConnect pick the most recently used object:

Wolfram Language code: ServiceConnect["OpenAI"]

Delete a service object created with ServiceConnect:

Wolfram Language code: ServiceConnect["OpenAI"]
Wolfram Language code: DeleteObject@%
Wolfram Language code: ServiceObjects[]

Options  (3)

Authentication  (2)

Connect to the OpenAI API using the Authentication option to send an API key:

Wolfram Language code: openAI = ServiceConnect["OpenAI", Authentication -> "myOpenAIKey"]
Wolfram Language code: openAI["ImageCreate", {"Prompt" -> "a cute cat"}]

Connect to the Reddit API, authenticating with a particular Reddit app instead of the default Wolfram Connector app:

Wolfram Language code: consumerKey = "myConsumerKey"; consumerSecret = "myConsumerSecret";
Wolfram Language code: redditKey = SecuredAuthenticationKey[<|"ClientID" -> consumerKey, "ClientSecret" -> consumerSecret, "OAuthType" -> "AuthorizationCode", "OAuthVersion" -> "2.0", "UserAuthorizationURL" -> "https://www.reddit.com/api/v1/authorize?duration=permanent", "AccessTokenURL" -> "https://www.reddit.com/api/v1/access_token", "RedirectURI" -> Automatic, "VerifierInputFunction" -> "WolframConnectorChannel", "Scopes" -> {"identity", "edit", "flair", "history", "modconfig", "modflair", "modlog", "modposts", "modwiki", "mysubreddits", "privatemessages", "read", "report", "save", "submit", "subscribe", "vote", "wikiedit", "wikiread"}|>]
Wolfram Language code: reddit = ServiceConnect["Reddit", "New", Authentication -> redditKey]
Wolfram Language code: reddit["UserData"]

SaveConnection  (1)

Create a connection and save it to your cloud account:

Wolfram Language code: CloudConnect[];
Wolfram Language code: openAI = ServiceConnect["OpenAI", "testConnection", SaveConnection -> True]
Wolfram Language code: id = openAI["ID"]
Wolfram Language code: openAI["Authentication"]
Wolfram Research (2014), ServiceConnect, Wolfram Language function, https://reference.wolfram.com/language/ref/ServiceConnect.html (updated 2025).

Text

Wolfram Research (2014), ServiceConnect, Wolfram Language function, https://reference.wolfram.com/language/ref/ServiceConnect.html (updated 2025).

CMS

Wolfram Language. 2014. "ServiceConnect." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2025. https://reference.wolfram.com/language/ref/ServiceConnect.html.

APA

Wolfram Language. (2014). ServiceConnect. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ServiceConnect.html

BibTeX

@misc{reference.wolfram_2026_serviceconnect, author="Wolfram Research", title="{ServiceConnect}", year="2025", howpublished="\url{https://reference.wolfram.com/language/ref/ServiceConnect.html}", note=[Accessed: 13-June-2026]}

BibLaTeX

@online{reference.wolfram_2026_serviceconnect, organization={Wolfram Research}, title={ServiceConnect}, year={2025}, url={https://reference.wolfram.com/language/ref/ServiceConnect.html}, note=[Accessed: 13-June-2026]}