With the FreshBooks API, you can build applications that:
import { axios } from "@pipedream/platform"
export default defineComponent({
props: {
freshbooks: {
type: "app",
app: "freshbooks",
}
},
async run({steps, $}) {
return await axios($, {
url: `https://api.freshbooks.com/auth/api/v1/users/me`,
headers: {
Authorization: `Bearer ${this.freshbooks.$auth.oauth_access_token}`,
},
})
},
})
FreshBooks uses OAuth authentication. When you connect your FreshBooks account, Pipedream will open a popup window where you can sign into FreshBooks and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any FreshBooks API.
Pipedream requests the following authorization scopes when you connect your account:
GET
https://auth.freshbooks.com/oauth/authorize/
?
client_id={{oauth.client_id}}
&
redirect_uri={{oauth.redirect_uri}}
&
state={{oauth.state}}
&
response_type=code
&
scope={{oauth.space_separated_scopes}}
POST
https://api.freshbooks.com/auth/oauth/token
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.freshbooks.com/auth/oauth/token
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}}