Partilhar via


Entegrations.io (Preview)

Entegrations.io, inc provides 3 broad set of features. 1) PayPal Invoicing, Payouts and IPN features leveraging your PayPal account. 2) Webhooks for Invoicing and Contacts leveraging your Xero account. 3) QBO Inovice leveraging your QuickBooks Online account.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name entegrations.io inc support
URL https://www.entegrations.io/#contact
Email support@entegrations.io
Connector Metadata
Publisher entegrations.io inc
Website https://www.entegrations.io
Privacy policy https://www.entegrations.io/privacy.html
Categories Productivity

Entegrations.io provides Invoicing, Payouts and IPN data that leverages your PayPal account. The Invoicing feature allows creating and sending invoices to a receiver via PayPal platform. Payouts feature allows sending Payouts to one or more receivers via PayPal platform. IPN feature allows receiving PayPal IPN data. All these 3 features work by proxying thru a third-party i.e. entegrations.io. You would need credentials before you could use this connector. For this, you would need to go thru a one-time PayPal authorization and to allow us to create Invoices or Payouts on your behalf. Visit https://portal.entegrations.io/portal for on-boarding instructions. As part of the on-boarding, you would get API Key that you could use for the connection while using custom connector on Microsoft Flow.

Prerequisites

Subscribing to one of the plans available at https://portal.entegrations.io/portal is a prerequisite to use this connector. To start with, you can chose a basic plan. As part of subscription and enabling this connector there, you would get an API key to be used.

How to get credentials

  1. Sign-up to a suitable plan at https://portal.entegrations.io/portal
  2. Sign-in to go the "My Account" page.
  3. Find this connector under "Available connectors/apps" section. Enable the connector and follow the one-time auth flow.
  4. Access and copy the auto-generated API key and use it in your flow while using this connector.

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Key securestring The API Key for this api True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Advanced Use: Delete the invoicing, payouts etc webhook

Advanced Use: Deletes the Entegrations.io webhook that corresponds to the PayPal webhook.

Create a PayPal Invoice

Create a draft PayPal Invoice and immediately sends it to a receiver as per their APIs https://developer.paypal.com/docs/api/invoicing/v1/#invoices_create and https://developer.paypal.com/docs/api/invoicing/v1/#invoices_send

Create a QBO Invoice

Create and sends and a QuickBooks Online Invoice as per their API https://developer.intuit.com/app/developer/qbo/docs/api/accounting/ecommerce/invoice

Create PayPal Payouts

Create PayPal Payouts to one or more receivers as per their API https://developer.paypal.com/docs/api/payments.payouts-batch/v1/#payouts_create

Delete the Contacts webhook

Deletes the Entegrations.io webhook that corresponds to the Xero Contacts updates webhook.

Delete the generic IPN webhook

Deletes the Entegrations.io webhook that corresponds to the PayPal IPN's generic webhook.

Delete the invoice paid webhook

Deletes the Entegrations.io webhook that corresponds to the PayPal Invoice paid webhook.

Delete the Invoices webhook

Deletes the Entegrations.io webhook that corresponds to the Xero Invoices webhook.

Delete the IPN's express_checkout completed webhook

Deletes the Entegrations.io webhook that corresponds to the PayPal IPN's express_checkout completed webhook.

Delete the IPN's new_case created webhook

Deletes the Entegrations.io webhook that corresponds to the PayPal IPN's new_case created webhook.

Delete the IPN's recurring_payment completed webhook

Deletes the Entegrations.io webhook that corresponds to the PayPal IPN's recurring_payment completed webhook.

Delete the payouts success webhook

Deletes the Entegrations.io webhook that corresponds to the PayPal Payouts success webhook.

Advanced Use: Delete the invoicing, payouts etc webhook

Advanced Use: Deletes the Entegrations.io webhook that corresponds to the PayPal webhook.

Parameters

Name Key Required Type Description
ID of the Webhook being deleted
webhookId True string

ID of the Webhook being deleted

Create a PayPal Invoice

Create a draft PayPal Invoice and immediately sends it to a receiver as per their APIs https://developer.paypal.com/docs/api/invoicing/v1/#invoices_create and https://developer.paypal.com/docs/api/invoicing/v1/#invoices_send

Parameters

Name Key Required Type Description
Sender's email
email True string

Sender's email which corresponds to PayPal account.

Sender's first name
first_name string

Sender's first name.

Sender's last name
last_name string

Sender's last name.

Sender's business name
business_name string

Sender's business name.

Sender's country code of phone
country_code string

Country code of the phone.

Sender's phone number with area code
national_number string

Phone nuber with area code.

Sender's Address 1
line1 True string

Line 1 of address.

Sender's City
city True string

City

Sender's State
state string

State

Sender's Postal Code
postal_code string

Postal Code

Sender's Country Code
country_code True string

Two character ISO country code.

Bill to email
email True string

Bill to email. This may be an email of reciever's PayPal account.

Billing First name
first_name string

First name

Billing Last name
last_name string

Last name

Shipping First name
first_name string

First name

Shipping Last name
last_name string

Last name

Shipping Address 1
line1 string

Line 1 of address.

Shipping City
city string

City

Shipping State
state string

State

Shipping Postal code
postal_code string

Postal code

Shipping Country code
country_code string

Country code

Item name
name string

Item name

Item Quantity
quantity string

Quantity. For e.g. 1.5

Unit Price Currency
currency True string

Currency

Unit Price Value
value True string

Value

Item Tax type/name
name True string

Tax type/name

Item Tax Percent
percent True string

Percent. For e.g. 8.5

Discount percent
percent string

Percent

Shipping Cost Currency
currency string

Currency

Shipping Cost Value
value string

Value

Invoice note
note string

Invoice note

Invoice terms
terms string

Invoice terms

Returns

Response details including status.

Create a QBO Invoice

Create and sends and a QuickBooks Online Invoice as per their API https://developer.intuit.com/app/developer/qbo/docs/api/accounting/ecommerce/invoice

Parameters

Name Key Required Type Description
Sender's email
SenderEmail True string

Sender's email which corresponds to Intuit QuickBooks Online account.

Sender's Realm ID or Company ID
RealmId True string

Sender's Realm ID or Company ID which corresponds to Intuit QuickBooks Online account.

Transaction Date
TxnDate string

Transaction Date in YYYY-MM-DD format

Due Date
DueDate string

Due Date in YYYY-MM-DD format

DocNumber
DocNumber string

DocNumber

Amount
Amount True double

Amount

Detail Type
DetailType True string

Detail Type

Value
value True string

Value

Name
name True string

Name

Customer Ref
value True string

Customer Ref

Returns

Response details including status.

Create PayPal Payouts

Create PayPal Payouts to one or more receivers as per their API https://developer.paypal.com/docs/api/payments.payouts-batch/v1/#payouts_create

Parameters

Name Key Required Type Description
Sender's email
email True string

Sender's email which corresponds to PayPal account.

Sender's Batch ID
sender_batch_id string

Sender's Batch ID (Should be unique value, in last 30 days, per PayPal).

Email Subject
email_subject string

Subject of the email notification that would be sent out by PayPal.

Receiver Type
recipient_type string

Recipient type. Valid values are either of EMAIL / PAYER_ID / PHONE. Either this value or the ones in Payout item/details is mandatory.

Receiver Type
recipient_type string

Recipient type. Valid values are either of EMAIL / PAYER_ID / PHONE. Either this value or the one in Payout batch header is mandatory.

Receiver (email / payer id / phone)
receiver True string

Receiver's email / PayPal payer_id / phone number.

Note
note string

Payout item level note.

Sender's Item ID
sender_item_id string

Sender's Payout Item ID (Should be unique value, in last 30 days, per PayPal).

Currency
currency True string

Currency

Value
value True string

Value

Returns

Delete the Contacts webhook

Deletes the Entegrations.io webhook that corresponds to the Xero Contacts updates webhook.

Parameters

Name Key Required Type Description
ID of the Webhook being deleted
webhookId True string

ID of the Webhook being deleted

Delete the generic IPN webhook

Deletes the Entegrations.io webhook that corresponds to the PayPal IPN's generic webhook.

Parameters

Name Key Required Type Description
txnType of the Webhook being deleted
txnType True string

txnType of the Webhook being deleted

txnStatus of the Webhook being deleted
txnStatus True string

txnStatus of the Webhook being deleted

ID of the Webhook being deleted
webhookId True string

ID of the Webhook being deleted

Delete the invoice paid webhook

Deletes the Entegrations.io webhook that corresponds to the PayPal Invoice paid webhook.

Parameters

Name Key Required Type Description
ID of the Webhook being deleted
webhookId True string

ID of the Webhook being deleted

Delete the Invoices webhook

Deletes the Entegrations.io webhook that corresponds to the Xero Invoices webhook.

Parameters

Name Key Required Type Description
ID of the Webhook being deleted
webhookId True string

ID of the Webhook being deleted

Delete the IPN's express_checkout completed webhook

Deletes the Entegrations.io webhook that corresponds to the PayPal IPN's express_checkout completed webhook.

Parameters

Name Key Required Type Description
ID of the Webhook being deleted
webhookId True string

ID of the Webhook being deleted

Delete the IPN's new_case created webhook

Deletes the Entegrations.io webhook that corresponds to the PayPal IPN's new_case created webhook.

Parameters

Name Key Required Type Description
ID of the Webhook being deleted
webhookId True string

ID of the Webhook being deleted

Delete the IPN's recurring_payment completed webhook

Deletes the Entegrations.io webhook that corresponds to the PayPal IPN's recurring_payment completed webhook.

Parameters

Name Key Required Type Description
ID of the Webhook being deleted
webhookId True string

ID of the Webhook being deleted

Delete the payouts success webhook

Deletes the Entegrations.io webhook that corresponds to the PayPal Payouts success webhook.

Parameters

Name Key Required Type Description
ID of the Webhook being deleted
webhookId True string

ID of the Webhook being deleted

Triggers

Advanced Use: When an IPN (generic) update is received

Advanced Use: Creates an entegrations.io webhook for PayPal IPN event data and it triggers whenever entegrations.io receives an on-behalf-of IPN payload from PayPal. Note that this is default payload, getting you whatever PayPal sends out.

Advanced Use: When invoicing, payouts updates received

Advanced Use: Creates an entegrations.io webhook for PayPal Invoicing, Payouts etc webhooks data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload from PayPal. Note that this is default payload, getting you whatever PayPal sends out.

Whenever a Contact is created or updated at Xero

Creates an entegrations.io webhook for Xero Contacts data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload for Contacts from Xero.

Whenever an invoice (at PayPal) is paid

Creates an entegrations.io webhook for PayPal Invoicing Paid data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload for Invoice Paid from PayPal.

Whenever an Invoice is created or updated at Xero

Creates an entegrations.io webhook for Xero Invoices updates data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload for Invoices from Xero.

Whenever Express Checkout payment is completed

Creates an entegrations.io webhook for PayPal express_checkout completed IPN event and it triggers whenever entegrations.io receives an on-behalf-of ipn payload from PayPal.

Whenever New Case is created

Creates an entegrations.io webhook for PayPal new case created IPN event and it triggers whenever entegrations.io receives an on-behalf-of ipn payload from PayPal.

Whenever payouts is paid

Creates an entegrations.io webhook for PayPal Payouts Paid data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload for Payouts Paid from PayPal.

Whenever Recurring Payment is completed

Creates an entegrations.io webhook for PayPal recurring payment completed IPN event and it triggers whenever entegrations.io receives an on-behalf-of ipn payload from PayPal.

Advanced Use: When an IPN (generic) update is received

Advanced Use: Creates an entegrations.io webhook for PayPal IPN event data and it triggers whenever entegrations.io receives an on-behalf-of IPN payload from PayPal. Note that this is default payload, getting you whatever PayPal sends out.

Parameters

Name Key Required Type Description
txn_type of the IPN being created.
txnType True string

txn_type of the IPN being created. Leave all for all txn_types.

txn or payment status of the Webhook being created.
txnStatus True string

txn or payment status of the Webhook being created. Leave all for all statuses.

paypalEmailAddress
paypalEmailAddress True string

Email address of the PayPal account. You must use the same PayPal email address you have used to on-board for the connector.

Returns

Advanced Use: When invoicing, payouts updates received

Advanced Use: Creates an entegrations.io webhook for PayPal Invoicing, Payouts etc webhooks data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload from PayPal. Note that this is default payload, getting you whatever PayPal sends out.

Parameters

Name Key Required Type Description
paypalEmailAddress
paypalEmailAddress True string

Email address of the PayPal account. You must use the same PayPal email address you have used to on-board for the connector.

Returns

Whenever a Contact is created or updated at Xero

Creates an entegrations.io webhook for Xero Contacts data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload for Contacts from Xero.

Parameters

Name Key Required Type Description
xeroEmailAddress
xeroEmailAddress True string

Email address of the Xero account. You must use the same Xero email address you have used to onboard for the custom connector.

Returns

Whenever an invoice (at PayPal) is paid

Creates an entegrations.io webhook for PayPal Invoicing Paid data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload for Invoice Paid from PayPal.

Parameters

Name Key Required Type Description
paypalEmailAddress
paypalEmailAddress True string

Email address of the PayPal account. You must use the same PayPal email address you have used to on-board for the connector.

Returns

Whenever an Invoice is created or updated at Xero

Creates an entegrations.io webhook for Xero Invoices updates data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload for Invoices from Xero.

Parameters

Name Key Required Type Description
xeroEmailAddress
xeroEmailAddress True string

Email address of the Xero account. You must use the same Xero email address you have used to onboard for the custom connector.

shouldGetInvoiceAsPdf
shouldGetInvoiceAsPdf boolean

Indicate if invoice has also to be gotten as PDF from Xero in addition to invoice resource.

Returns

Whenever Express Checkout payment is completed

Creates an entegrations.io webhook for PayPal express_checkout completed IPN event and it triggers whenever entegrations.io receives an on-behalf-of ipn payload from PayPal.

Parameters

Name Key Required Type Description
paypalEmailAddress
paypalEmailAddress True string

Email address of the PayPal account. You must use the same PayPal email address you have used to on-board for the connector.

Returns

Whenever New Case is created

Creates an entegrations.io webhook for PayPal new case created IPN event and it triggers whenever entegrations.io receives an on-behalf-of ipn payload from PayPal.

Parameters

Name Key Required Type Description
paypalEmailAddress
paypalEmailAddress True string

Email address of the PayPal account. You must use the same PayPal email address you have used to on-board for the connector.

Returns

Whenever payouts is paid

Creates an entegrations.io webhook for PayPal Payouts Paid data and it triggers whenever entegrations.io receives an on-behalf-of webhook payload for Payouts Paid from PayPal.

Parameters

Name Key Required Type Description
paypalEmailAddress
paypalEmailAddress True string

Email address of the PayPal account. You must use the same PayPal email address you have used to on-board for the connector.

Returns

Whenever Recurring Payment is completed

Creates an entegrations.io webhook for PayPal recurring payment completed IPN event and it triggers whenever entegrations.io receives an on-behalf-of ipn payload from PayPal.

Parameters

Name Key Required Type Description
paypalEmailAddress
paypalEmailAddress True string

Email address of the PayPal account. You must use the same PayPal email address you have used to on-board for the connector.

Returns

Definitions

EntegrationsInvoice4PayPalCreateResponse

Response details including status.

Name Path Type Description
status
status string

Status of creating the Invoice. Possible values: success or error.

paypal_invoice_id
details.paypal_invoice_id string

Invoice ID generated by PayPal.

paypal_invoice_number
details.paypal_invoice_number string

Invoice Number generated by PayPal.

errorMessage
errorMessage string

Error message, if there is any error.

EntegrationsPayouts4PayPalCreateResponse

Name Path Type Description
status
status string

Status of creating the Payouts. Possible values: success or error.

paypal_payout_batch_id
details.paypal_payout_batch_id string

Batch ID generated by the PayPal for this Payout.

sender_batch_id
details.sender_batch_id string

Batch ID that was sent in the request (echoing back the same value)

errorMessage
errorMessage string

Error message, if there is any error.

EntegrationsWebhook4PayPalDefaultPushResponse

Name Path Type Description
ID as given by PayPal
id string
create_time as given by PayPal
create_time string
event_type as given by PayPal
event_type string
resource_type as given by PayPal
resource_type string
summary as given by PayPal
summary string
resource as given by PayPal
resource object
Stringified version of the resource given by PayPal
resource_json_stringified string

EntegrationsWebhook4PayPalInvoicingPaidPushResponse

Name Path Type Description
ID as given by PayPal
invoice_paid_paypal_invoice_id string
create_time as given by PayPal
invoice_paid_time string
summary as given by PayPal
invoice_paid_summary string
resource as given by PayPal
invoice_paid_resource object

EntegrationsWebhook4PayPalPayoutsPaidPushResponse

Name Path Type Description
ID as given by PayPal
payouts_batch_success_paypal_payout_batch_id string
create_time as given by PayPal
payouts_batch_success_time string
summary as given by PayPal
payouts_batch_success_summary string
resource as given by PayPal
payouts_batch_success_resource object

EntegrationsWebhook4PayPalIpnEcCompletedPushResponse

Name Path Type Description
txn_id as given by PayPal
txn_id string
payment_date as given by PayPal
payment_date string
mc_gross as given by PayPal
mc_gross string
mc_fee as given by PayPal
mc_fee string
payer_email as given by PayPal
payer_email string

EntegrationsWebhook4PayPalIpnNewCaseCreatedPushResponse

Name Path Type Description
case_creation_date as given by PayPal
case_creation_date string
case_id as given by PayPal
case_id string
buyer_additional_information as given by PayPal
buyer_additional_information string
case_type as given by PayPal
case_type string
reason_code as given by PayPal
reason_code string

EntegrationsWebhook4PayPalIpnRecurringPaymentCompletedPushResponse

Name Path Type Description
txn_id as given by PayPal
txn_id string
payment_date as given by PayPal
payment_date string
custom value (that you must have used during your integration with PayPal and that's) as given by PayPal
custom string
payment_status as given by PayPal
payment_status string
amount as given by PayPal
amount string
first and last name, if they are null. Otherwise, the business name. These values are as given by PayPal
payer_full_name string
payer_email as given by PayPal
payer_email string

EntegrationsWebhook4XeroInvoicesPushResponse

Name Path Type Description
resourceUrl as given by Xero
resource_url string
resourceId as given by Xero
resource_id string
eventDateUtc as given by Xero, for e.g. 2017-06-21T01:15:39.902
event_date_tc string
eventType as given by Xero. Can be Create or Update
event_type string
eventCategory as given by Xero. Can be INVOICE or CONTACT, but INVOICE for this scenario.
event_category string
tenantId as given by Xero, for e.g. c2cc9b6e-9458-4c7d-93cc-f02b81b0594f
tenant_id string
tenantType as given by Xero, which is ORGANISATION for now
tenantType string
Invoice resource as given by Xero.
invoice_resource object
When fetching this invoice as PDF, this optional field can contain Base64 version of application/pdf content given by Xero.
invoice_pdf_as_base64 object

EntegrationsWebhook4XeroContactsPushResponse

Name Path Type Description
resourceUrl as given by Xero
resource_url string
resourceId as given by Xero
resource_id string
eventDateUtc as given by Xero, for e.g. 2017-06-21T01:15:39.902
event_date_tc string
eventType as given by Xero. Can be Create or Update
event_type string
eventCategory as given by Xero. Can be INVOICE or CONTACT, but CONTACT for this scenario.
event_category string
tenantId as given by Xero, for e.g. c2cc9b6e-9458-4c7d-93cc-f02b81b0594f
tenant_id string
tenantType as given by Xero, which is ORGANISATION for now
tenantType string
contact resource as given by Xero
contact_resource object

EntegrationsInvoice4IntuitCreateResponse

Response details including status.

Name Path Type Description
status
status string

Status of creating the Invoice. Possible values: success or error.

intuit_invoice_id
details.intuit_invoice_id string

Invoice ID generated by QuickBooks.

intuit_invoice_number
details.intuit_invoice_number string

Invoice Number generated by QuickBooks.

errorMessage
errorMessage string

Error message, if there is any error.