Following are the steps for sending data to your AbuseHQ instance.
Create a Data Channel in app.abusix.com
- Navigate to
- Click on
Create a Data Channeland follow the steps in the wizard. We currently offer three ways of creating Data Channels.
Select how you would like to send your data to AbuseHQ
If you are sending your data
- via API see Submitting data via the API to Data Channels
- via SMTP see Submitting data via email to Data Channels
Name your Data Channel and describe the data
- For Email, please add details on what you are planning to report. For the type of information we are looking for, see Submitting data via email to Data Channels.
Specify how Abusix may use your data
- In the last step of the wizard, please select how Abusix is allowed to use your data.
Forwarding data after the Data Channel is configured.
After configuring your Data Channel take the following steps
Forwarding your email via SMTP
If you are forwarding an abuse@ role address
- Check if your “role address” is an existing alias address and if Abusix can be added as an additional alias to the address. You may have already done this by
- If your role address supports aliasing, add the Data Channel forwarding address (e.g., firstname.lastname@example.org) as an alias in your email server.
Make a connection to our API.
- Our API uses XARF, a format for reporting abuse, for mapping. Glance through our XARF documentation and closely examine the JSON schema examples. Most standard schemas should work for you, but you may have one that we don’t have in our examples or may have a field that you don’t see in the standard published schemas. In these exceptions, contact us through Chat or at email@example.com. XARF and our architecture are extensible; it's just that if we have mapped the type of abuse you are reporting before, we want to be sure you are using that preexisting mapping as much as possible since that ensures you are compatible with new features as we iterate forward.
- Open your tool of choice and make a POST-Request to our API using a simple curl command, a library in your programming language, or any other way you wish.
- Pass the Data Channel API-Key we have provided as an HTTP header.
- Place the JSON XARF formatted file into the request's body and send it.
- After successfully posting your data, you can check to see if it's working correctly or see any errors in Data Channel at app.abusix.com.
Learn more about Data Channels
This will help provide you with an Overview of the XARF Format
Send us a message
Having trouble with your set up or a technical issue? Get in touch with our team of Abusix experts.
Click the chat button at the bottom and send us your questions. Alternatively, you can email us at firstname.lastname@example.org