With the FreeAgent API, you can build applications that:
import { axios } from "@pipedream/platform"
export default defineComponent({
props: {
freeagent: {
type: "app",
app: "freeagent",
}
},
async run({steps, $}) {
return await axios($, {
url: `https://api.freeagent.com/v2/users/me`,
headers: {
Authorization: `Bearer ${this.freeagent.$auth.oauth_access_token}`,
},
})
},
})
FreeAgent uses OAuth authentication. When you connect your FreeAgent account, Pipedream will open a popup window where you can sign into FreeAgent and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any FreeAgent API.
Pipedream requests the following authorization scopes when you connect your account:
GET
https://api.freeagent.com/v2/approve_app
?
client_id={{oauth.client_id}}
&
redirect_uri={{oauth.redirect_uri}}
&
state={{oauth.state}}
&
response_type=code
&
scope={{oauth.space_separated_scopes}}
POST
https://api.freeagent.com/v2/token_endpoint
content-type: application/x-www-form-urlencoded
accept: application/json
client_id={{oauth.client_id}}
&
client_secret={{oauth.client_secret}}
&
redirect_uri={{oauth.redirect_uri}}
&
grant_type=authorization_code
&
code={{oauth.code}}
POST
https://api.freeagent.com/v2/token_endpoint
content-type: application/x-www-form-urlencoded
accept: application/json
client_id={{oauth.client_id}}
&
client_secret={{oauth.client_secret}}
&
grant_type=refresh_token
&
refresh_token={{oauth.refresh_token}}