Skip to main content

TURL_SendAuthorizationPIN (function reference)

By October 1, 2021October 13th, 2021Online Help, Troi URL plug-in
Troi URL Plug-in > Functions reference > TURL_SendAuthorizationPIN
Troi URL Plug-in for FileMaker Pro


This will send the PIN (obtained while granting access) to the web service to complete the authorization.

SyntaxFunction badge

TURL_SendAuthorizationPIN ( switches ; method ; accessTokenURL ; PIN )


switches determine the behaviour of the function
method either POST or GET
accessTokenURL URL to obtain the final access token (and access token secret) from the web service
PIN the PIN (obtained by the user while granting access)


switches must be set to:

-OAuthProtocol the plug-in is using the OAuth protocol

you can also use:

-ReturnDataAfterError return the error code followed by the data

Returned Result

Data type returned



If successful this function returns several named parameters separated by ampersands. In this result are the two credentials access_token and access_token_secret

Originated in

Troi URL Plug-in 2.6


FileMaker Pro 16 to 19


This function provides the second step and completes the authorization.
The plug-in currently only supports the OAuth 1.0A Authorization protocol.

The credentials access_token and access_token_secret need to be stored, to be able to perform requests in the future. Normally you can keep using these two credentials, until the user revokes them (on the web service site). Take care to keep the credentials secret, as they are tied to the userID on the web service.


Set Variable [ $PIN ; "123456" ] 
Set Variable [ $Twitter_Access_token_step_URL ; "" ] 
#send the PIN to Twitter to complete the authorization:
Set Variable [ $Twitter_Result ; TURL_SendAuthorizationPIN ( "-OAuthProtocol" ; "POST" ;
 		$Twitter_Access_token_step_URL ; $PIN ) ]

if succesfull $Twitter_Result will be like:


See the example on how to parse this into separate fields.

Related functionsFunction badge


Related script stepScript step badge

Send Authorization PIN URL

Related topics

Troi URL Plug-in online help (overview)

Online Help Page for Troi URL Plug-in for 16 to 19 –> TURL_SendAuthorizationPIN (urlp4415) 2021-1013 16:32:27